100% Offline & Private 🦀 Safe Rust (0% Unsafe) ⚡ <10ms Cold Startup 🎨 18 Built-in Themes 🛡️ 311 Tests Passed

Terminal Pomodoro & Task Management in Pure Rust

A keyboard-driven, ultra-responsive productivity system crafted with Ratatui. No Electron bloat, zero telemetry, sub-10ms cold startup and sub-15MB RAM footprint (both measured on Linux, release build; results vary), and instant focus flow.

⚡ Get Started 📖 Explore All Features →

Termodoro timer view in a KDE terminal showing a large ASCII countdown clock, progress gauge, cycle tracker dots, and the active task target panel.

Focus Session in Catppuccin Mocha: 5-row ASCII digital clock, progress gauge, cycle tracker, and active task target.

Engineered for Focus

Why Developers Choose Termodoro

Built from scratch in safe, modern Rust to deliver the cleanest terminal productivity experience with zero distractions.

⚡

Sub-10ms Startup & Minimal RAM

Compiled directly to native machine code with Ratatui and Crossterm. Launches in milliseconds and stays lightweight in RAM — figures below 10 ms startup and 15 MB RSS were measured on a Linux development machine (release build); results vary by hardware and OS.

🛡️

100% Offline & Zero Telemetry

Your tasks, analytics, and preferences are stored strictly on your local disk adhering to XDG standards. Zero cloud dependencies, accounts, or trackers.

🎨

18 Built-in High-Contrast Themes

Switch on the fly between Catppuccin, Nord, Gruvbox, Tokyo Night, Dracula, Kanagawa, Everforest, Rose Pine, Synthwave '84, and pure OLED pitch black.

🔔

Pure In-Memory Audio Synthesis

Procedural RIFF WAV sound generation for Zen Tibetan singing bowls (528 Hz harmonics) and crisp alerts, paired with native desktop notifications.

📊

Productivity Analytics & Streaks

Track daily focus time, 7-day visual bar charts, total Pomodoro counts, and consecutive active day streaks with automatic calendar day rollover.

🪟

tmux & Zellij Multiplexer Ready

Runs directly inside side-panes, floating windows, or dedicated workspace tabs with responsive Unicode gauge resizing and status reporting.

Aesthetics & Ergonomics

18 Curated Color Palettes

Click any palette card below to preview the color scheme live across the website.

Quick Start

Installation & Setup

Get up and running in seconds via Cargo, source build, or multiplexer integration.

Linux (Ubuntu / Debian / Arch / Fedora)

# 1. Install ALSA audio headers & build tools (one-time setup)
# Ubuntu / Debian:
sudo apt update && sudo apt install -y build-essential git libasound2-dev pkg-config

# Arch Linux:
sudo pacman -S --needed base-devel git alsa-lib pkgconf

# Fedora / RHEL:
sudo dnf install -y git alsa-lib-devel pkgconf-pkg-config

# 2. Install Termodoro globally via Cargo
cargo install --git https://github.com/amanalip/Termodoro.git

# (Optional) Or compile locally from source:
git clone https://github.com/amanalip/Termodoro.git && cd Termodoro && cargo install --path .

# 3. Launch Termodoro
termodoro

macOS (Apple Silicon M1-M4 & Intel)

# 1. Install Xcode Command Line Tools & Rust (if not already installed)
xcode-select --install
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

# 2. Install Termodoro globally with Cargo
cargo install --git https://github.com/amanalip/Termodoro.git

# 3. Ensure ~/.cargo/bin is in your PATH
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

# 4. Launch in iTerm2, Ghostty, Alacritty, or Terminal.app
termodoro

Windows (PowerShell / Windows Terminal)

# 1. Install Rust with MSVC C++ Build Tools via https://rustup.rs

# 2. Install Termodoro globally in PowerShell
cargo install --git https://github.com/amanalip/Termodoro.git

# 3. Ensure Cargo bin is in User PATH (if needed)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.cargo\bin", "User")

# 4. Launch Termodoro
termodoro

tmux & Zellij Integration

# --- Option A: tmux Floating Popup Modal (tmux 3.2+ in ~/.tmux.conf) ---
bind-key P display-popup -E -w 75% -h 75% "termodoro"

# --- Option B: tmux 30% Horizontal Split Pane (in ~/.tmux.conf) ---
bind-key T split-window -h -p 30 "termodoro"

# --- Option C: Zellij Floating Modal Window ---
zellij run --floating --width 75% --height 75% -- termodoro

Standalone Release Binary

# 1. Compile optimized standalone release artifact (~5.1 MB)
cargo build --release

# 2. Copy binary to your local user PATH directory:
# Linux & macOS:
mkdir -p ~/.local/bin && cp target/release/termodoro ~/.local/bin/ && chmod +x ~/.local/bin/termodoro

# Windows (PowerShell):
Copy-Item target\release\termodoro.exe $env:USERPROFILE\.cargo\bin\

# 3. Launch Termodoro from anywhere
termodoro

Cheat Sheet

Ergonomic Keybindings Reference

Vim-inspired shortcuts designed for speed and zero mouse dependence.

Key / Shortcut	Action Description	Context
Space	Toggle Start / Pause (Timer) • Toggle Task Done (Tasks) • Toggle Flag (Settings)	Contextual
r	Reset current countdown timer to initial duration	Timer
s	Skip current Pomodoro or Break phase immediately	Timer
1 / 2 / 3 / 4	Jump directly to Timer (1), Tasks (2), Stats (3), Settings (4) — on the Tasks tab, 1/2/3 switch backlog filters instead (4 still jumps)	Global (except Tasks filters)
Tab / Shift+Tab	Cycle forward / backward sequentially through all navigation tabs	Global
a	Open Add Task modal (Title input + 1-20 Pomodoro estimation)	Timer / Tasks
t	Bind highlighted task as active goal target for the Pomodoro timer	Tasks
Enter	Toggle completed status on selected task • Save task modal	Tasks / Modals
d / x	Delete highlighted task from backlog	Tasks
j / ↓ • k / ↑	Navigate cursor up / down through task list rows or settings items	Tasks / Settings
1 / 2 / 3	Switch task backlog view filters: [1] All • [2] Active • [3] Completed	Tasks
h / ← • l / → (or + / -)	Adjust interval duration mins or cycle through all 18 color themes	Settings / Modals
?	Toggle floating Help & Keybindings popup modal overlay	Global
q	Safely persist state to disk and quit	Global
Esc	Dismiss the active modal or dialog	Contextual