Tomatick

Quick Start

A menu bar timer, stopwatch, alarm and pomodoro — all in one icon, with a timestamped history of everything you run. Runs on macOS, Windows, and Linux. Rewritten from the original Python app (macOS-only) as a single Go binary.

All three builds are unsigned — no Apple Developer Program, no code-signing certificate. Each OS has its own one-time first-launch step; see below.

1. Install

macOS (Apple Silicon, M1–M4)

  1. Download the latest Tomatick-x.y.z-macos-arm64.zip from the Releases page.
  2. Unzip it and drag Tomatick.app onto the Applications folder.
  3. First launch only: right-click Tomatick in Applications → Open → Open. (A plain double-click is blocked the first time because the app is unsigned.) If macOS still refuses, run once in Terminal: 
    xattr -dr com.apple.quarantine /Applications/Tomatick.app

Windows (x86_64)

  1. Download the latest Tomatick-x.y.z-windows-amd64.exe from the Releases page. There is no installer — run the .exe directly, from wherever you saved it.
  2. First launch only: SmartScreen will warn that the publisher is unknown, because the build is unsigned. Click More info → Run anyway.

Linux (x86_64)

  1. Download the latest Tomatick-x.y.z-linux-amd64.tar.xz from the Releases page.
  2. tar -xJf Tomatick-x.y.z-linux-amd64.tar.xz
cd tomatick
sudo make install     # or: make user-install  (installs under ~/.local)
    Installs the binary, a .desktop entry, and the icon. No signing step.
  3. A tray host that speaks StatusNotifierItem / AppIndicator is required to see the menu bar icon (GNOME needs an extension; KDE and most other desktops work out of the box).

Tomatick is a menu bar / system tray app — there's no taskbar window. Look for the 🍅 (or stopwatch) icon in the menu bar (macOS), notification area (Windows), or system tray (Linux). Click it for everything.

2. Start something

Click the menu bar icon → Start:

  • Timer — a natural duration: 25m, 1h30m, 90s, 2:30, or a bare number (minutes).
  • Stopwatch — counts up; supports laps.
  • Pomodoro — 25 / 5 / 15 by default, auto-advancing work ↔ break, long break every 4th work cycle.
  • Alarm — one-shot (a date + time) or recurring (a time on chosen weekdays).

Every running session is listed in the menu. Click one for Pause/Resume and Stop, plus Reset (timer & stopwatch), Skip phase (pomodoro) or Lap (stopwatch) — and Pin to make its countdown the one shown in the menu bar. When a timer finishes it keeps ringing until you click Dismiss, so you won't miss it.

3. Presets (one-click timers)

Save the timers you start often (it ships with Focus 25:00 and Quick break 5:00):

  • Use one: Start menu → pick a preset under the divider.
  • Manage them: Settings → Presets tab → Add / Edit / Delete.

4. Settings

Open Settings… from the menu — one window with tabs:

TabWhat's in it
GeneralDefault sound, snooze minutes, global hotkey, launch at login, Export / Import Settings
PomodoroWork / break lengths, auto-start, Focus during work
PresetsManage quick-start timers
AlarmsAdd / edit / delete alarms
HistoryFull event log — Export to CSV/JSON, Clear
AboutVersion, credits, links

5. Focus / Do-Not-Disturb during work (macOS only)

Tomatick can turn a macOS Focus on during a pomodoro work phase and off on breaks. macOS has no public API for this, so it runs Shortcuts you create. This feature does not exist on Windows or Linux — there's no equivalent OS-level Focus/DND API to hook into, so the setting is a no-op there.

  1. Open Shortcuts → + for a new shortcut.
  2. Add Set Focus → choose your Focus → Turn On. Name it e.g. Tomatick Focus On.
  3. Make a second shortcut that Turns Off that Focus, e.g. Tomatick Focus Off.
  4. In Tomatick → Settings → Pomodoro, type those exact names into Focus Shortcut (on)/(off) and tick Trigger Focus during work phases. Save.

Leave the names blank to disable the feature.

6. Global hotkey

Settings → General → Global hotkey: pick an action (Start Pomodoro, Start Timer, or Toggle Keep Awake) and a key (e.g. ⌥⌘P). On macOS the first use prompts for Accessibility permission (System Settings → Privacy & Security → Accessibility).

7. Keep Awake

Menu → Keep awake prevents sleep while it's on. Bindable to the hotkey; turns itself off on quit.

8. Copy your setup to another device

  1. Settings → General → Export Settings… → save the .json.
  2. On the other device: Import Settings… → pick that file.

This copies presets, pomodoro lengths, sounds, snooze, Focus shortcut names, hotkey, and alarms. (Launch-at-login stays per-machine.)

Where your data lives

macOS:    ~/Library/Application Support/Tomatick/
Windows:  %AppData%\Tomatick\
Linux:    $XDG_DATA_HOME/Tomatick/ (or ~/.local/share/Tomatick/)

├── config.json     # all settings, presets, alarms
└── history.db      # SQLite event history

It never leaves your device. See the Privacy Policy for the details.

Questions or bugs? See the GitHub repository.