oxitime

Crates.iooxitime
lib.rsoxitime
version0.1.0
created_at2025-06-04 12:29:37.781627+00
updated_at2025-06-04 12:29:37.781627+00
descriptionOxitime is a fast, minimal, and terminal-native Pomodoro time tracker built with the Rust programming language.
homepage
repository
max_upload_size
id1700276
size245,919
Iago Bozza (writeonlycode)

documentation

README

Oxitime 🦀⏱️

Oxitime is a fast, minimal, and terminal-native Pomodoro time tracker built with the Rust programming language. Stay focused, beat procrastination, and reclaim your time — one oxidized session at a time.

Features

  • 🍅 Pomodoro technique (25/5 intervals)
  • ⏱️ Command-line interface (lightning fast)
  • 🔔 Notifications (desktop alerts)
  • ⚙️ Configurable session durations
  • 🦀 Blazingly fast and portable (Rust-powered)

Installation

Coming soon: Precompiled binaries and cargo install.

For now, clone and build manually:

git clone https://github.com/yourusername/oxitime.git
cd oxitime
cargo build --release

Then run it from target/release/oxitime.

Usage

oxitime start        # Start a Pomodoro session
oxitime short-break  # Start a short break
oxitime long-break   # Start a long break

Configuration

Customize durations and preferences with a simple config file at ~/.config/oxitime/config.toml:

pomodoro_duration = "30m" 
short_break_duration = "5m" 
long_break_duration = "30m" 

Roadmap

  • ✅ Basic Pomodoro timer
  • ✅ Desktop notifications
  • 🔜 Session persistence & logs
  • 🔜 Stats and productivity graphs

Contributing

Pull requests are welcome! If you find a bug or want a new feature, open an issue.

License

MIT License © Iago Bozza

Thanks

Commit count: 0

cargo fmt