doxa/doxa-timer/MANUAL.md

DOXA Timer User Manual ⏱️

This manual explains how to use the DOXA Timer application.

Getting Started

Run the program with:

doxa-timer

When you first launch the app, you will see a startup screen. Press Enter to access the main interface.

Interface States

1. READY: The timer is set and waiting for you to start.
2. FOCUS: Work interval. Focus on your tasks.
3. SHORT BREAK / LONG BREAK: Relax. The countdown signals the break duration.
4. SETTINGS: Configuration menu to set durations.
5. STATS: Historical data.

Controls

Main Screen

• Space: Starts or pauses the countdown.
• r: Resets the countdown back to the configured focus or break time.
• s: Opens Settings.
• t: Opens Stats.
• l: Toggles UI translation (English/Czech).
• q / Esc: Exits the application.

Settings Screen

• up/down or k/j: Navigate between different settings options:
  • Focus time
  • Short break time
  • Long break time
  • Long break after X pomodoros
• + / -: Increase or decrease the value of the active option.
• Enter: Save settings and return to the main screen.
• q / Esc: Go back to the main screen without saving changes.

Stats Screen

• q / Esc: Return to the main screen.