https://github.com/writeonlycode/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.
https://github.com/writeonlycode/oxitime
Last synced: 7 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/writeonlycode/oxitime
- Owner: writeonlycode
- License: mit
- Created: 2025-05-19T10:48:21.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-05-28T11:18:02.000Z (8 months ago)
- Last Synced: 2025-05-30T15:35:13.470Z (8 months ago)
- Language: Rust
- Size: 155 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
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:
```bash
git clone https://github.com/yourusername/oxitime.git
cd oxitime
cargo build --release
```
Then run it from target/release/oxitime.
## Usage
```bash
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:
```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
- Alarm Sound Effect by u_inx5oo5fv3 from Pixabay.