Gruvodoro
| Crates.io | Gruvodoro |
| lib.rs | Gruvodoro |
| version | 0.1.0 |
| created_at | 2026-01-10 16:56:26.333411+00 |
| updated_at | 2026-01-10 16:56:26.333411+00 |
| description | A minimalist Gruvbox Pomodoro timer with glassmorphic flair |
| homepage | |
| repository | https://github.com/meegol/Gruvodoro |
| max_upload_size | |
| id | 2034433 |
| size | 448,519 |
(meegol)
documentation
README
Gruvodoro
A minimalist, glassmorphic Pomodoro timer built with Rust and egui, designed for a premium distraction-free experience.
Features
- Minimalist Glass Aesthetic: Deep charcoal background with retro-inspired Gruvbox colors and a semi-transparent, borderless window.
- Smart Transitions: Automatically cycles through Work, Short Break, and Long Break.
- Direct Interaction: Click the title to rename it, or the large clock to change the duration directly.
- Eye-Friendly Palette: No aggressive reds; uses a calm Gruvbox Aqua/Blue scheme.
- Performance: Extremely lightweight, written in native Rust.
Installation (Linux)
To install Gruvodoro to your system, run the provided install script:
./install.sh
This will:
- Build the application in release mode.
- Install the binary to
~/.local/bin/gruvodoro. - Install the desktop entry to
~/.local/share/applications/gruvodoro.desktop. - Install the icon to
~/.local/share/icons/gruvodoro.png.
Desktop Integration (Hyprland)
To get the full "glass" effect with background blur, add these windowrulev2 rules to your hyprland.conf:
windowrulev2 = float, class:^(Gruvodoro)$
windowrulev2 = size 300 400, class:^(Gruvodoro)$
windowrulev2 = opacity 0.9 0.8, class:^(Gruvodoro)$ # Semi-transparent
windowrulev2 = blur, class:^(Gruvodoro)$ # Enable background blur
Developing
Prerequisites
- Rust (Cargo)
Run locally
cargo run --release
License
MIT