Support
A pomodoro timer that silences your iPhone while you work and logs each session against a task.
Need help or found a problem? Email alexus2005@gmail.com. Include your iPhone model and iOS version, and a screenshot if you can.
Getting started
- Open the Timer tab and tap Start focus.
- Type what you're working on and press Return. A 25 min focus starts.
- When time's up, a break starts by itself. Every 4th break is a long one.
- Open History to see your totals by task.
Change the timer lengths in Settings.
Setting up Do Not Disturb
iOS doesn't let apps switch Do Not Disturb, so Heads Down runs two shortcuts that you make once in the Shortcuts app. The names must match exactly.
- Heads Down On: tap +, add the Set Focus action and tap Off to change it to On. Tap Turned Off and choose Time, tap the time, tap Select Variable and choose Shortcut Input. Then add the Nothing action below it.
- Heads Down Off: a second shortcut with just the Set Focus action, set to Turn Off.
- In Heads Down, open Settings › Do Not Disturb and tap Test. It should say "Both shortcuts work."
- Turn on My shortcut turns off by itself, so Do Not Disturb ends with the focus even when your iPhone is locked.
Each time a focus starts, the Shortcuts app opens for about a second, then Heads Down comes back.
Adding a widget
- Touch and hold an empty area of your Home Screen until the apps jiggle, then tap Edit › Add Widget.
- Search for Heads Down and tap Add Widget.
For the Lock Screen, touch and hold the Lock Screen, tap Customize › Lock Screen, then tap the widget area. While a focus or break runs, a Live Activity shows the countdown on the Lock Screen and in the Dynamic Island.
Questions
It says "Couldn't turn on Do Not Disturb"
Check that the shortcut is named exactly Heads Down On, then run Test again in Settings › Do Not Disturb. The timer keeps running either way.
Shortcuts asks to let the shortcut output a text item
The Heads Down On shortcut is missing the Nothing action. Add it at the end. If you tapped Always Allow, Shortcuts added a "Stop and output" action. Delete that action and add Nothing in its place.
I don't hear anything when a focus ends
Turn on Ring when time's up in the app's Settings. It rings like an alarm, even on silent or in Do Not Disturb. If you use notifications instead, check that Settings › Notifications › Heads Down › Time Sensitive Notifications is on.
Do Not Disturb stayed on after my focus ended
Heads Down can't run a shortcut while it's closed. Turn on "My shortcut turns off by itself" as described above, or open Heads Down and it turns Do Not Disturb off.
How do I share my hours?
Open History, pick a period and tap the share button. Heads Down hands a CSV file to the iOS share sheet, so you can send it with Mail, Messages or AirDrop, or save it to Files.
How do I fix a session logged against the wrong task?
In History, swipe the session left and tap Change task. To rename a task everywhere, swipe it in the task picker and tap Rename.
Why wasn't my session saved?
A focus that's stopped in under a minute isn't saved. A longer one is saved as "Stopped early".
Is my data private?
Yes. Your tasks and sessions stay on your iPhone. The app sends anonymous usage statistics that never include your task names or history. See the privacy policy.