Pomotroid is a configurable Pomodoro timer designed to help users track productivity efficiently using the Pomodoro Technique.
Key Features:
Customize work intervals, break lengths, and the number of rounds with persistent settings.
Enjoy charming alert sounds (optional) to mark the end of each session.
Receive desktop notifications (optional) to stay on track throughout your workflow.
Minimize Pomotroid to the system tray for uninterrupted productivity.
Choose from a variety of included themes or create custom themes to match your preferences.
Log timer activity to review progress and adjust settings over time.
Audience & Benefit:
Ideal for remote workers, students, and professionals seeking to improve focus and manage time effectively. Pomotroid helps users maintain productivity by providing structure and flexibility to adapt the Pomodoro Technique to their unique work style.
Available for Windows, Mac, and Linux, Pomotroid can be installed via winget or downloaded as a standalone application.
Pomotroid is a simple and configurable Pomodoro timer. It aims to provide a visually-pleasing and reliable way to track productivity using the Pomodoro Technique.
Minimise / close to tray — keep Pomotroid running in the background
Desktop notifications — native OS alerts on round transitions
Compact mode — a minimal set of controls appears when the window is resized small
Always on top — optionally keep the timer above other windows
WebSocket server — opt-in local server for stream overlays and external integrations
Diagnostic logging — rotating log file with a one-click shortcut to the log folder
Statistics
Pomotroid tracks every completed session and surfaces the data across three views: a daily summary with an hourly breakdown, a weekly bar chart with streak tracking, and an all-time 52-week heatmap.
Themes
Pomotroid ships with 37 themes and supports fully custom themes with live hot-reload.
See THEMES.md for the full theme list and instructions on creating your own.
Install
Download
Download the latest release from the releases page.
Available for Windows (installer + standalone exe), macOS (universal DMG), and Linux (.deb + AppImage).
> Note: Pomotroid is currently unsigned. Depending on your OS security settings you may see a warning on first launch — this is expected and can be safely dismissed.
Homebrew (macOS)
brew install --cask pomotroid
> The Homebrew cask is maintained separately and may lag behind the latest release. Check the releases page for the most current version.
Custom Themes
Pomotroid supports user-created themes with automatic hot-reload — no restart required. See THEMES.md for directory paths, the full color reference, and a step-by-step guide.
WebSocket API
Pomotroid exposes an optional WebSocket server (disabled by default) for integration with external tools, stream overlays, and automation scripts.
Enable it in Settings → Advanced → WebSocket Server, then connect to ws://127.0.0.1: (default port: 1314).
See CONTRIBUTING.md for full setup instructions, project structure, and the release process.
Quick start
# Install dependencies
npm install
# Run in development mode (hot-reload)
npm run tauri dev
# Build a production release
npm run tauri build
Localization
UI strings live in src/messages/.json (en, es, fr, de, ja, zh, pt). The compiled output in src/paraglide/ is generated at build time and is not committed to the repository.
During development, the Paraglide Vite plugin compiles messages automatically whenever npm run tauri dev or npm run tauri build is run — no manual step required.
After adding or changing message keys, regenerate the output explicitly so that svelte-check and your editor can pick up the new types:
npm run paraglide:compile
This is also run automatically as part of npm run check.
