Pomotroid Free and Open Source Desktop App CookApps CookApps Marketplace

Overview

Pomotroid is a visually-pleasing, highly configurable open-source Pomodoro focus timer rebuilt with Tauri 2, Rust, and Svelte 5. Featuring 38 built-in themes (Dracula, Nord, Tokyo Night, Catppuccin), 52-week focus heatmaps, custom sound alerts, global hotkeys, and a built-in WebSocket API, Pomotroid keeps deep work sessions organized across macOS, Windows, and Linux.

How It Works

Pomotroid operates through structured, deterministic execution stages:

Customizable Focus Cycle Engine: Tunes work sessions, short breaks, long break intervals, and timer progression cleanly for sustained cognitive focus.

52-Week Productivity Heatmap Analytics: Persists local daily and weekly focus logs into interactive charts and annual activity matrices.

38+ Bundled Dynamic Themes: Ships curated themes including Dracula, Nord, Tokyo Night, and Catppuccin with OS light/dark synchronization.

Tauri 2 + WebSocket API: Combines Svelte 5 and Rust with global hotkeys, custom sound alerts, and a local WebSocket API for Stream Deck or script automation.

Pomotroid Pomodoro timer desktop workspace with custom color themes

Pomotroid 52-week focus session activity heatmap and breakdown

Key Technical Features & Capabilities

Precision Pomodoro Session Engine: Customizes work durations, short breaks, long breaks, rounds per cycle, and auto-start transitions cleanly.

Interactive Stats & 52-Week Heatmap: Tracks daily, weekly, and all-time focus streaks locally with activity charts and calendar heatmaps.

38 Bundled Themes & Custom JSON Themes: Switches themes automatically alongside macOS/Windows system dark/light preference or loads user-authored JSON palettes live.

Global Shortcuts & WebSocket API: Controls timers seamlessly via OS-wide hotkeys and broadcasts live state events over WebSocket for automation integrations.

Architecture & Technology Stack

Primary Languages: Rust (Tauri 2 Backend), TypeScript, Svelte 5

Frameworks & Styling: Tauri 2 Desktop Shell, Vite, Tailwind / CSS Variables

Localization: 8 Languages (English, Spanish, French, German, Japanese, Chinese, Turkish, Portuguese)

Supported Platforms: macOS Universal DMG, Windows 10/11 Setup EXE, Linux (AppImage, .deb, .rpm)

System Requirements

Specification	Minimum Requirement	Recommended Specification
Operating System	macOS (Universal DMG), Windows 10/11 x64, Linux	Latest stable release build
Processor Architecture	4-Core x86_64 or Apple Silicon M1	8-Core Apple Silicon / Core i7+
Memory (RAM)	4 GB Unified Memory	16 GB+ High-Speed RAM
Disk Space	1 GB free SSD storage	5 GB+ free SSD storage

Installation & Setup Guide

macOS & Windows Installation

macOS: Download Pomotroid_1.7.1_universal.dmg from CookApps or run brew install --cask pomotroid.

Windows: Download Pomotroid_1.7.1_x64-setup.exe and follow the Windows installer.

Building from Source

bash

git clone https://github.com/Splode/pomotroid.git
cd pomotroid
npm install
npm run tauri dev

How to Use & Workflow

Configure Timer Durations: Open Settings to dial in focus lengths (e.g. 25/50m), break rules, and custom alert chimes.

Choose Visual Theme: Pick from 38 curated palettes (Catppuccin, Nord, Gruvbox) or auto-sync Light/Dark palettes with your OS.

Track Deep Work Streaks: Inspect daily session logs and 52-week focus heatmaps in the Statistics tab.

Troubleshooting & Common Issues

Issue: macOS Gatekeeper prevents opening downloaded DMG build.

*Cause*: Open-source DMG requires first-launch clearance when unnotarized.

*Resolution*: Right-click Pomotroid.app › Open or run xattr -cr /Applications/Pomotroid.app.

Pomotroid