Crock is a modern, terminal-based Pomodoro and Task Management tool built with Rust and Ratatui. It helps you stay focused with a clean, high-visibility clock and an integrated task queue.
- Big Text Timer: High-visibility countdown powered by
tui-big-text. - Task Management: Create, edit, and reorder your task queue.
- Dynamic Status: Visual indicators for running, paused, and upcoming tasks.
- Flexible Time Parsing: Input time in natural formats like
25m,1h 30m, or45s. - System Notifications: Get alerted when a task timer finishes.
- Modern UI: Clean layout with rounded borders and intuitive color coding.
Config file is currently in $HOME/.config/crock/config.toml, you can preset tasks there. Here is an example:
[[tasks]]
desc = "sit"
time = "45min"
[[tasks]]
desc = "stand"
time = "10min"# Clone the repository
git clone https://github.com/your-username/crock.git
cd crock
# Build and run
cargo run --releaseCrock uses context-aware keybindings to keep the interface clean.
p: Pause / Resume the timerr: Start / Restart the current taskt: Stop the current taske: Switch to Task List management?: Toggle Help paneq: Quit application
a: Add a new task (opens dialog)r: Edit the focused taskd: Delete the focused taskj/k: Move focus down / upEnter: Set the focused task as the Current TaskEsc/q: Return to Clock View
Tab: Switch between Description and Duration fieldsEnter: Confirm and save taskEsc: Cancel and return to list
The UI is divided into several logical sections:
- Status Bar: Shows the app name and current state (RUNNING/PAUSED).
- Main Timer: Displays the current task name and a large countdown.
- Progress Bar: Visual representation of the remaining time.
- Next Up: A preview of the next task in your queue.
- Footer: Quick-reference keybindings for the current context.
Copyright (c) Charon Ryui Charon_Ryui@outlook.com
This project is licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT)