doxa/doxa-timer/README.md

DOXA Timer ⏱️

Minimalist Pomodoro timer for the terminal with local statistics

DOXA Timer is a terminal-based Pomodoro app. It alternates focus work sessions with short and long breaks to optimize concentration, while tracking your sessions locally.

Features

• Pomodoro Technique: Standard Focus (25m), Short Break (5m), and Long Break (15m).
• Live Countdown & Progress: Interactive ASCII progress bar.
• Persistent Local Stats: Tracking of today's and total Pomodoros.
• Customizable Intervals: Adjust times inside the app settings.
• Sovereign & Offline: Everything is saved locally at ~/.doxa-timer/doxa_timer.json.
• Bilingual TUI: Switch between English and Czech using the l key.

Installation

Go to the doxa-timer folder and run the install script:

chmod +x install.sh
./install.sh

Hotkeys

• Space - Start / Pause / Resume
• r - Reset current timer
• s - Open Settings (press +/- to adjust times, Enter to Save, q to Cancel)
• t - Show Statistics
• l - Toggle language (EN/CS)
• q or Esc - Go back / Quit