ScheduleApp — user guide

What this is

ScheduleApp shows your monthly work schedule on your phone, pulled from the same roster file that's normally only available as a PDF. It reads that file, finds your row, and shows it two ways — a source-style row (just like the PDF) and a normal calendar grid — so you can always check it against the original if anything looks off.

It also has a few extras built on top: shift alarms, a mandatory end-of-shift toolbox-check reminder, and home-screen widgets.

The app only talks to my own private schedule server — nothing else, no ads, no analytics, no data going anywhere you haven't asked it to.

Since this is the very first build you're getting, there's no changelog yet — future updates will list what changed here.

1. Installing

1. Download the APK from the downloads page.
2. Your phone will probably ask you to allow installs from this source the first time — this is a normal Android prompt for anything installed outside the Play Store, allow it just for that app.
3. Open the APK and install.

2. First-time setup — pairing

The first time you open the app, it needs to pair with the schedule server once.

1. On the Import tab, ask me for a pairing code — valid for 15 minutes, works once.
2. Enter (or scan) the code when prompted.
3. Once paired, you won't need to do this again — the app keeps a token on your phone.

3. Getting your schedule

Once paired, you have two ways to get your schedule onto your phone. Either is fine — the difference is how much you check along the way.

The normal way (recommended the first time):

1. Press Check files on server on the Import tab — always a manual button press, the app never checks on its own.
2. Pick the revision you want (usually the newest one) and download it.
3. Go to My PDfs, find the file, tap Confirm.
4. Search for your name and select yourself.
5. Compare the shown schedule against the actual PDF crop on screen, confirm it matches.
6. When asked "Set as your active schedule?", tap Yes.

The shortcut ("one-click roster"):

On the Import screen there's a name field and a slide-to-activate button ("show me the real magic"). Type your name, slide it, and wait a few seconds — it fetches the latest schedule, finds your name, and activates it automatically, no comparison step. Once it's done, tap Open roster tab to see the result.

This is faster, but it skips the manual comparison — the Roster screen will show a small "not verified by you" note until you go through the normal Confirm flow at least once for that same schedule. Use whichever you're comfortable with; if you use the shortcut, it's worth glancing at the real PDF yourself afterward.

4. Viewing your roster

The Roster tab shows your active schedule two ways — a horizontal source row (matching the PDF layout) and a normal month grid. Switch between them freely; both show exactly the same raw values, nothing translated or guessed. A gear icon at the top jumps back to My PDfs if you need to pick a different revision.

5. Understanding your codes (Rules tab)

Each code on your schedule (numbers, TR, ill, VAC, and so on) maps to a meaning — hours, category, whether it counts as a working day. The Rules tab shows this dictionary and lets you fix or add an entry if something's wrong or missing. The app never guesses at an unknown code — it'll flag it instead of silently assuming.

6. Alarms

The Alarms tab has separate cards for Day, Night, and Training (TR) shifts, since they can start at different times. For each one you can:

• Set the shift-start time and how much advance warning you want.
• Choose whether that reminder rings as a full alarm, shows as a plain notification, or both — independently for each card.

Android will likely ask for a few permissions the first time you set an alarm (exact alarms, notifications, and a battery-optimization exemption for this app) — all three matter for the alarm to actually go off reliably, so it's worth granting them when asked.

7. Toolbox checks

If your schedule includes working (Day/Night) shifts, the Toolbox tab reminds you to check your toolbox before leaving — by default, 30 minutes before your shift ends. (Training days don't get this reminder — no physical tools involved.)

You can confirm a check three different ways, whichever's in front of you at the time:

• The button on the alarm screen, if it rings.
• The action button on the notification, if you're just using notifications.
• Directly in the Toolbox tab's list, for any day — including catching up on one you missed confirming earlier.

You can optionally attach a photo as proof, either right away or later, from the entries list.

Two more things live on that tab:

• Toolbox check records — turn the whole tracking list on or off, and see a day-by-day history with a tick for confirmed days.
• Entries cleanup — set how long old entries stick around before they're quietly deleted (or set it to never, which is the default).

8. Home-screen widgets

Long-press an empty spot on your home screen → Widgets → find ScheduleApp → pick one of three: next-day info, your roster line, or a combined view. They update automatically whenever your schedule, rules, or alarms change — no need to reopen the app.

Troubleshooting

• "Person not found" when using the one-click shortcut — check your name matches exactly how it's spelled on the official roster (including any middle name or how your surname/given name are ordered).
• Alarm or toolbox reminder didn't go off — check the three permissions mentioned in the Alarms section, especially battery optimization, since some phone manufacturers are aggressive about killing background apps.
• Something on the Roster screen looks wrong — always trust the real PDF over the app, and let me know so I can fix it.

Feedback

Found a bug, or something's confusing? Message me directly — — I'd rather hear about problems now than have them surface once more people are using it.