Support

Help for Daily Runbook on iPhone and iPad.

Get in touch: most answers are on this page. For anything else, open an issue at github.com/amgarcia2235/runbook-site/issues. We reply within 48 hours.

Issues are public. Please do not post a diagnostics report, health details, addresses or the times of your day there. A diagnostics report goes by email, once an address is listed here.

Getting started

  1. Pick your kind of work. You can change it later in Profile > What kind of work.
  2. Open Profile (the person icon, top left). Tap Home, then Work: type the address, or tap Use where I am now while you are there.
  3. Turn on Trip logging and allow location. It needs Always, with Precise Location on, so times log with the app closed. If iOS only offers While Using, change it in iPhone Settings > Privacy & Security > Location Services > Daily Runbook.
  4. Turn on Drive detection and allow Motion & Fitness.
  5. Set your hours in Profile > Hours, holidays and repeating rows.
  6. Tap Connect Apple Health on Today. Connect Calendar and Connect Reminders are in Profile, if you want them.

On a big site, such as a campus or a plant, open Profile > Work and set Site size to cover every building and the lot.

Want to look around first? Profile > Show a sample day fills the app with made-up data. Your own log is untouched.

Common questions

A time did not log. Open Plan > Log and tap the day. In version 1.4 and later, the section "Why was this missed?" says in plain words what got in the way. The usual causes:

To fix the day, tap Add a missing event on the same page, or tap a time to change it. iOS decides when location events arrive, so now and then one can still come late or not at all.

It logged me leaving, or a break, when I never left. Indoors, the phone's position can drift a few hundred meters, so a big site can look like you stepped out. Open Profile > Work > Site size, make the circle cover every building and the lot, and tap Save. On the Work tab, tap Not a break on any break that was not one; the app learns that spot and can suggest a bigger site. A wrong time can be swiped away in Plan > Log.

A break or a meal is wrong. On the Work tab, the Breaks card has Not a break, and a break you logged yourself can be changed or deleted there. On Today, Start break and End break log one by hand while you are on site. A stop at mealtime asks on Today: pick Breakfast, Lunch, Dinner, Snack or Not a meal. For a stop that was not one, like a traffic jam, open Plan > Log, tap the day and swipe it (Not a stop).

A drive did not show up. Turn on Drive detection in Profile and allow Motion & Fitness (iPhone Settings > Privacy & Security > Motion & Fitness). Drives come from the iPhone's motion sensors. The app reads them when it refreshes, so a drive can appear a little after you open the app.

No sleep, steps or heart numbers. Tap Connect Apple Health on Today, or in Health settings. Then, in the Health app, tap your picture, then Apps, then Daily Runbook, and turn on what you want to see. Sleep shows when something writes it to Apple Health, such as an Apple Watch worn to bed or your Sleep schedule. Heart rate, sound levels and stand hours come from an Apple Watch. Health records show only after you tap Connect health records on the Health tab.

The weather is missing, or says "Weather paused until tomorrow". The weather follows your Home place (or Work). With no place set, it uses where you are, if location is allowed; set Home if the card asks for a place. "Weather paused until tomorrow" means the app reached its daily weather limit. That is a safety limit, not normal use: the card keeps the last reading and the weather comes back the next day. If you see it more than once, please tell us. Weather data is provided by Apple Weather.

Trucking: can the duty clock be my hours-of-service log? No. It is a personal duty clock, an awareness tool for your own day, worked out from your drives and your taps. It is not an electronic logging device (ELD) and not a record of duty status; your carrier's log is the record.

Can I give the mileage log to my tax preparer? Yes, as your own notes. With the Rideshare / gig delivery job, the app keeps a mileage log: the miles of each drive (estimated from the route), each drive marked Business or Personal, valued at the IRS standard rate in force that day. Export it with Export my mileage log (CSV), in Plan > Log or on the Business miles card on the Work tab. It is not tax advice; keep your own records too.

Where is my data? Does anything leave my phone? Your log stays on your device, in the app's own storage. There is no account and no server, and the app has no ads and no analytics. The app does not sync your log; it is part of your own iCloud Backup or computer backup, so a restored phone keeps it. Only weather, drive-time and place lookups go to Apple. Health samples are read from Apple Health and never stored by the app; the optional daily health history and the Care page stay on the device and, from version 1.4, are left out of backups. To keep a copy, use Profile > Data > Export my log as JSON or CSV. Deleting the app deletes the log. A diagnostics report leaves your phone only if you send it. The privacy policy has the details.

How do I send a diagnostics report? Profile > Data > Diagnostics shows what the sensors delivered and when. In version 1.4 and later, tap Send diagnostics to send a report by mail or the share sheet. It holds the app version, your permissions and the sensor log, with no health values, no addresses and no place names. It does hold times of day, so please send it by email, not in a public issue.