mirror of
https://codeberg.org/Kankys/doxa.git
synced 2026-11-11 06:44:36 +01:00
33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
# 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
|