Question 1

How to create a custom theme in Pomotroid?

Accepted Answer

Drop a JSON file with color keys into the themes folder; Pomotroid supports live hot-reload, so changes apply instantly. Refer to THEMES.md for a full color reference and step-by-step instructions.

Question 2

Pomotroid vs. Focus Keeper – which is better for Mac users?

Accepted Answer

Pomotroid offers more customization, statistics, and cross-platform support, while Focus Keeper is simpler and Mac-native. Choose Pomotroid for advanced features, or Focus Keeper for a streamlined, Apple-integrated experience.

Question 3

Does Pomotroid work on Linux without extra setup?

Accepted Answer

It works out-of-the-box on most Linux desktops like KDE, but GNOME users need to install an extension for system tray support, as mentioned in the Linux notes. Other environments require no additional steps.

Question 4

Can I sync Pomotroid data between my laptop and desktop?

Accepted Answer

No, Pomotroid lacks built-in cloud sync; statistics are stored locally. You'd need to manually copy data files or use third-party tools to transfer them across devices.

Question 5

How to use the WebSocket API for OBS stream overlays?

Accepted Answer

Enable the WebSocket server in Settings → Advanced, then connect to ws://127.0.0.1:1314 to receive real-time events like round changes, which can be displayed using OBS browser sources or custom scripts.

Question 6

Is Pomotroid open source, and how can I contribute translations?

Accepted Answer

Yes, it's MIT licensed on GitHub. To contribute translations, edit the JSON files in src/messages/ and run npm run paraglide:compile, as outlined in the Localization section.

Pomotroid

What is Pomotroid?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions