Pomotroid
An open-source Pomodoro timer for Windows, macOS and Linux with configurable work and rest cycles, statistics, global shortcuts, tray progress, themes and an optional local WebSocket interface.
What Pomotroid does
Pomotroid schedules personal focus and rest sessions and reports daily, weekly and long-term session statistics. It does not read the active application, websites or task content like an activity tracker, so a completed timer represents a session rather than verified work hours or output.
Themes, shortcuts and local interface
The desktop app can run in the tray, customize themes and sounds, and optionally expose timer state through a local WebSocket for trusted overlays or automation. WebSocket is disabled by default and should remain bound to the loopback interface unless a narrowly controlled integration requires otherwise.
Maintenance note
This page reviews Pomotroid 1.7.1, platform builds, timer statistics, themes, global shortcuts, unsigned-package prompts, local WebSocket behavior and MIT licensing. Content review date: 2026-08-23.
Save to your cloud drive
Open the cloud drive to get the file directly, or save it for convenient access on another device.
Quark Cloud Drive
RecommendedSave Pomotroid to this cloud drive
Baidu Netdisk
Save Pomotroid to this cloud drive
Pomotroid 1.7.1 installation, statistics and local interface guide
Configure short test cycles, verify notifications, tray behavior, shortcuts and statistics, then consider themes, sounds or WebSocket only after basic timing is reliable.
Before you start
- Match Windows x64, the macOS universal image or Linux x86_64 package, and prepare to review an unsigned-app prompt according to the platform rules.
- Record work, short-break, long-break and cycle counts so the timer fits real commitments.
- If an overlay or automation needs WebSocket, identify the one trusted local process and keep the port off external networks.
Installation steps
- 01
Install the platform build
Use the Windows installer or executable, macOS universal image or Linux AppImage, DEB or RPM, and confirm the version before the first session.
- 02
Configure cycles and notifications
Set work, short break, long break and cycle count, then use a short test period to check sound, desktop notifications, pause and automatic transitions.
- 03
Set tray, shortcuts and theme
Decide whether closing minimizes to the tray, test global shortcuts against other applications and keep original theme JSON and sound files beside their format notes.
Quick start
- 01
Complete one full cycle
Run a work session through a short break, compare tray progress, notifications and statistics, and only then restore the intended durations.
- 02
Read session statistics correctly
Treat daily, weekly and long-term charts as completed sessions and time distribution, not as billable hours; investigate pauses, sleep or duplicate instances.
- 03
Enable the local interface only when needed
Turn on WebSocket for a trusted overlay or automation, verify loopback listening and disable it after the integration test if it is no longer required.
Usage tips
- Pomotroid 1.7.1 provides multiple themes, global shortcuts and tray progress, but statistics do not measure task quality or automatically infer activity.
- Unsigned builds can trigger operating-system warnings; verify the file and version instead of trusting a same-name package from another source.
- A WebSocket endpoint exposes elapsed seconds, total duration, state and cycle type; widening its listener or proxy increases the control-plane scope.
Troubleshooting and uninstall
Why did the timer stop when the window closed?
Check close-to-tray and tray-icon settings, desktop support for tray indicators and whether more than one Pomotroid instance is running.
Why are notifications, shortcuts or custom sounds missing?
Check notification permission, do-not-disturb mode, audio format and shortcut conflicts, then restore built-in sound and default shortcuts for isolation.
- Save settings and statisticsRecord cycle configuration, required statistics, custom themes and sounds, and confirm no background timer or local interface remains active.
- Exit the tray and uninstallQuit Pomotroid completely from the tray, uninstall by platform and remove user data only after confirming that historical statistics and custom configuration are no longer needed.
Frequently asked questions
Does Pomotroid automatically know what task I am doing?
No. It records work and rest sessions and creates charts, but it does not inspect active applications, websites or task content like an activity tracker.
Is the WebSocket port open by default?
No. The feature is disabled by default and is intended for a local overlay or trusted automation. Enable it only when needed and keep the listener on loopback.
Why does the operating system warn about the installer?
The current build is unsigned, so Windows, macOS or Linux may display a first-run warning. Check the version and file before following the platform's confirmation flow.