habit+timer

doxa-timer/README.md

@@ -0,0 +1,32 @@
+# 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:
+
+```bash
+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