pomotroid

:tomato: Simple and visually-pleasing Pomodoro timer

What is pomotroid?

:tomato: Simple and visually-pleasing Pomodoro timer

Overview of pomotroid

What it is

Pomotroid is a simple and configurable Pomodoro timer built with Tauri 2, Rust, and Svelte 5. It provides a visually-pleasing and reliable way to track productivity using the Pomodoro Technique.

Key features

  • Configurable timer — customise work duration, break durations, and the number of rounds per long break
  • Statistics — daily, weekly, and all-time session history with charts and a 52-week heatmap
  • 38 bundled themes — including Dracula, Nord, Tokyo Night, Catppuccin, Gruvbox, Rose Piné, and more; auto-switches with OS light/dark preference
  • Custom themes — drop a JSON file into the themes folder; applied instantly without a restart
  • Localization — 8 languages: English, Spanish, French, German, Japanese, Chinese (Simplified), Turkish, and Portuguese; auto-detects OS language
  • Global shortcuts — control the timer from anywhere, even when the window is hidden
  • Custom audio — replace the built-in alert sounds with your own files
  • Tick sounds — optional ticking during work and break rounds, independently toggleable
  • Dynamic tray icon — progress arc updates in real time; reflects round type and pause state
  • 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

Use cases

  • Personal productivity tracking using the Pomodoro Technique
  • Managing work and break intervals with customisable durations
  • Reviewing daily, weekly, and all-time session statistics to analyse productivity patterns
  • Customising the timer appearance with built-in or user-created themes
  • Integrating with stream overlays or automation scripts via the WebSocket API

Getting started

### Install via Homebrew (macOS)
brew install --cask pomotroid

### Or run from source in development mode
npm install
npm run tauri dev

### Build a production release
npm run tauri build

License and pricing

MIT © Christopher Murphy. The software is open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/splodepomotroid.svg)](https://yunodb.com/tools/splodepomotroid?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/splodepomotroid?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/splodepomotroid.svg" alt="Featured on YunoDB" height="20"></a>