Support

Parkodoro lives in the menu bar, not in the Dock: look for its icon near the clock. On a MacBook with a notch, a full menu bar can hide icons behind it. Press ⌃⌘Z from any app to open the window, then make room in the menu bar or turn on the Dock icon in Settings.

Open Settings (the gear in the window’s bottom-right corner), click the shortcut next to Show/hide, and press the new combination. Esc cancels, ⌫ removes the shortcut. A shortcut needs at least one of ⌘, ⌃ or ⌥.

With ⌘ in it, holding ⌘ and pressing again moves through your timers, and letting go starts the selected one. Add ⇧ to move backwards. Without ⌘, the shortcut simply opens and closes the window.

The + in the window’s bottom-left corner adds a timer. Right-click a tile to edit or delete it, and drag tiles to reorder them.

A title that starts with an emoji shows as that emoji; anything else shows as text. Deleting doesn’t ask for confirmation: click Undo at the bottom of the window, or press ⌘Z.

Turn on Countdown and type minutes separated by colons, work first: 25:5 is 25 minutes of work and a 5-minute break, and 25:5:25:15 is a longer cycle. A number in parentheses is what gets logged: 25(30):5 runs for 25 minutes and records 30. With Repeating on, the cycle starts over until you stop it.

With Countdown off, the timer is a stopwatch that runs until you stop it.

Right-click the timer and choose Edit…, then click Edit next to Time tracked. Type a new duration over the old one: 1h 25m, 25m, 90 or 1:30 all work. The trash button next to a session deletes it. A running session can be edited once the timer stops.

On purpose. A session that starts before 5 am and continues your evening’s work (starting within two hours of the previous one) counts toward the evening’s day. If you start fresh at 4 am after a night’s sleep, that’s a new day.

Two other rules keep the log tidy: restarting a timer within five minutes continues the same session, and sessions shorter than a minute aren’t kept.

In a timer’s editor, Copy puts daily totals on the clipboard as plain text, and CSV saves every session with the columns Email, Start date, Start time and Duration, which Toggl and similar services can import. Parkodoro asks for the email once; you can change it in Settings.

No. Parkodoro never connects to the internet. To move your timers and log to another Mac, copy the data file (see below) and put it in the same place there while Parkodoro is not running.

Everything is in one file, data.json. Settings → Show data file in Finder takes you to it. Copying the file is a backup. To restore one, quit Parkodoro first, then replace the file.

The folder is ~/Library/Containers/com.keymasterr.parkodoro/Data/Library/Application Support/Parkodoro/.

In Settings, turn off Show icon in menu bar (and Show Dock icon, which is off by default). Parkodoro then opens as a small regular window, from the shortcut only. Parkodoro won’t let you remove both the icon and the shortcut, so you can always get back in.

Sounds at the end of a work interval or a break are on by default; check Sounds in Settings. The speaker button next to the time mutes sound until the timer stops.

Notifications are off by default. When you turn them on, they arrive quietly in Notification Center, without banners or sounds.

Quit Parkodoro (right-click the menu bar icon → Quit), and drag it from Applications to the Trash. To remove your data too, delete the folder ~/Library/Containers/com.keymasterr.parkodoro.