Tomatick
Class A (OSS/MIT). A menu bar / system tray timer, stopwatch, alarm and
pomodoro — all in one icon, with a timestamped history of everything you run.
This is a Go rewrite of the original macOS-only Python
Tomatick, built so a single codebase
runs on macOS, Windows, and Linux. Config and history use the same JSON /
SQLite schema, so a config.json from the Python app loads here.
Features
- Timer — natural-language durations (
25m, 1h30m, 90s, 2:30), with a
live M:SS countdown in the tray (menu-bar title on macOS; tooltip + menu on
Windows). Pause / Reset / Stop.
- Stopwatch — counts up, with optional laps. Pause / Reset / Stop.
- Pomodoro — 25/5/15 by default, auto-advancing phases (🍅 work, ☕ break),
long break after every 4th work cycle. Pause / Skip phase / Stop.
- Alarms — one-shot (a specific date + time) and recurring (a time of day on
chosen weekdays). Rings with a looping sound + notification until dismissed,
with Snooze (9 min default).
- Multiple at once — run several sessions together; the tray shows your
"primary" one live, and every active session is listed in the menu with its
own count. Pin any session to make it the primary display.
- History — every event (started / paused / completed / phase change / alarm
fired …) is timestamped into SQLite. See recent events in Settings and
Export the full log to CSV or JSON.
- Settings — edit pomodoro durations, default sound, icon theme, and toggle
Launch at login.
Everything is driven from the tray icon's menu: start a session → it appears in
the menu → click its item to pause/stop it (or dismiss a ringing alarm).
Run it (development)
Requires Go 1.25+. On Linux you also need the usual Fyne OpenGL/X11 headers
(libgl1-mesa-dev, xorg-dev). On Windows, a gcc (MinGW) is required because
Fyne uses CGO.
git clone https://github.com/MichalAFerber/tomatick2.git
cd tomatick2
go test ./...
go run ./cmd/tomatick
A tomato icon appears in the menu bar (macOS), notification area (Windows), or
system tray (Linux). Click it to open the menu.
On Linux, a tray host that speaks StatusNotifierItem / AppIndicator is required
(GNOME needs an extension; KDE and most other desktops work out of the box).
Run the tests
The timing, scheduling, history, and settings logic has no GUI dependencies:
go test ./internal/sessions ./internal/alarms ./internal/history ./internal/settings ./internal/core
go test ./... also compiles the UI packages (needs CGO + platform GUI libs).
Build a standalone app
# current OS
go build -o tomatick ./cmd/tomatick
# packaged bundles (run on the target OS, or use fyne-cross)
make package-mac # Tomatick.app, Dock-hidden
make package-windows # Tomatick.exe
make package-linux # Tomatick.tar.xz
fyne package must be installed. Pin it to the fyne.io/fyne/v2 version in
go.mod — the packager decides the bundle layout, so a floating @latest
changes it under you between releases. The release workflow pins the same
version:
go install fyne.io/fyne/v2/cmd/[email protected]
fyne.io/fyne/v2/cmd/fyne is deprecated upstream in favor of
fyne.io/tools/cmd/fyne (the old binary still works and prints a migration
notice on every run). Stay on the path above for now: fyne.io/tools is a
separate module with its own version numbers, not locked to fyne.io/fyne/v2,
so swapping it in here — and in .github/workflows/release.yml — needs its
own verification that packaging output doesn't change, not a drive-by edit.
On macOS the bundle is unsigned; on first launch right-click → Open to get past
Gatekeeper, or:
xattr -dr com.apple.quarantine /Applications/Tomatick.app
Tomatick is a tray app — no Dock icon on macOS (runtime
LSUIElement / accessory policy). Look for the tomato in the menu bar. To start
it at login, use the icon's menu → Settings → Launch at login.
Where data lives
| OS | Directory |
|---|
| macOS | ~/Library/Application Support/Tomatick/ |
| Windows | %AppData%\Tomatick\ |
| Linux | ~/.local/share/Tomatick/ |
config.json # pomodoro settings, alarms, sound, launch-at-login
history.db # SQLite event history
Honor TOMATICK_SUPPORT_DIR to redirect both files (used by tests).
Platform notes
| Capability | macOS | Windows | Linux |
|---|
| Tray title text | yes (next to the icon) | tooltip + menu | title where the tray supports it |
| Sounds | /System/Library/Sounds | %WINDIR%\Media | bundled ding + paplay/aplay |
| Keep awake | caffeinate | SetThreadExecutionState | systemd-inhibit |
| Launch at login | LaunchAgent us.tomatick | HKCU Run key | ~/.config/autostart/ |
| Focus / DND | Shortcuts app, by name | ignored | ignored |
| Global hotkey | Accessibility permission | RegisterHotKey | X11 grab |
Project layout
cmd/tomatick/ # main
internal/
sessions/ # Timer / Stopwatch / Pomodoro (pure logic)
alarms/ # Alarm model + scheduling (pure logic)
history/ # SQLite history store
settings/ # config.json load/save
core/ # tick, wiring, no GUI
ui/ # Fyne tray + settings windows
sound/ notify/ keepawake/ autostart/ hotkey/ focus/
assets/ # tomato art, bundled ding.wav
Website
The product site lives at tomatick.us (source still
in the Python repo).
Credits
The menu-bar tomato icon (red / white / black themes) and the app icon are
original artwork, generated by scripts/make_icon.py.
License
Released under the MIT License — © 2026 Michal Ferber.
