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.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.app

Uses built-in curl and ditto only.

Manual download

  1. Download the latest OnTime.dmg (or OnTime.zip). Older versions stay on the Releases page.
  2. Open the archive and drag OnTime into Applications.
  3. 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.app
xattr -cr /Applications/OnTime.app

Modes

  • 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:

URLAction
ontime://start?duration=25mStart countdown
ontime://add?duration=5mAdd time
ontime://pomodoroStart Pomodoro
ontime://stopwatchStart stopwatch
ontime://pause / resume / togglePause controls
ontime://skipSkip Pomodoro phase
ontime://stop / clearClear timer
ontime://settingsOpen 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.