Help
Overview
OnTime is a menu bar timer for macOS. Type a duration in plain language, run Pomodoro or a stopwatch, and keep sessions on your Mac — no account and no cloud.
Requires macOS 14 Sonoma or later.
Install
Terminal (recommended)
Paste this in Terminal to install the latest build and clear Gatekeeper quarantine. Works on a normal Mac with no extra tools. Replaces any existing /Applications/OnTime.app.
curl -fsSL -o /tmp/OnTime.zip https://github.com/RamiruWanigathunga/OnTime/releases/latest/download/OnTime.zip \
&& rm -rf /tmp/OnTime-extract \
&& ditto -x -k /tmp/OnTime.zip /tmp/OnTime-extract \
&& rm -rf /Applications/OnTime.app \
&& mv /tmp/OnTime-extract/OnTime.app /Applications/ \
&& xattr -cr /Applications/OnTime.app \
&& open /Applications/OnTime.appcurl -fsSL -o /tmp/OnTime.zip https://github.com/RamiruWanigathunga/OnTime/releases/latest/download/OnTime.zip \
&& rm -rf /tmp/OnTime-extract \
&& ditto -x -k /tmp/OnTime.zip /tmp/OnTime-extract \
&& rm -rf /Applications/OnTime.app \
&& mv /tmp/OnTime-extract/OnTime.app /Applications/ \
&& xattr -cr /Applications/OnTime.app \
&& open /Applications/OnTime.appUses built-in curl and ditto only.
Manual download
- Download the latest OnTime.dmg (or OnTime.zip). Older versions stay on the Releases page.
- Open the archive and drag OnTime into Applications.
- Launch OnTime from Applications. It appears in the menu bar.
Until builds are notarized, macOS may block the first launch after a browser download. Use Open Anyway in Privacy & Security, or clear quarantine with:
xattr -cr /Applications/OnTime.appxattr -cr /Applications/OnTime.appModes
- Countdown — type durations like
25m,1 hour and 39 min,10pm, or+5. - Stopwatch — count up from the menu bar.
- Pomodoro — configurable work/break cycles, skip phase, and +5 minutes when a session runs long.
- Stretch to set — drag down from the menu bar icon to set a countdown (Option for seconds; Esc cancels).
Keyboard shortcuts
Configurable in Settings: Open, Pause/resume, Clear, Start Pomodoro, and Start stopwatch.
URL scheme
Drive OnTime from Shortcuts, Alfred, Raycast, or scripts with ontime:// links:
| URL | Action |
|---|---|
ontime://start?duration=25m | Start countdown |
ontime://add?duration=5m | Add time |
ontime://pomodoro | Start Pomodoro |
ontime://stopwatch | Start stopwatch |
ontime://pause / resume / toggle | Pause controls |
ontime://skip | Skip Pomodoro phase |
ontime://stop / clear | Clear timer |
ontime://settings | Open Settings |
Session log
Events append locally to ~/Library/Application Support/OnTime/sessions.jsonl. Nothing is sent for analytics.
Credits
Based on TomatoBar by Artem Yurov / ivoronin, and Tock by Michael Edelstone.
More
Full source, issues, and release notes live on GitHub. See also the privacy policy.