taman 0.1.1

A TUI Pomodoro productivity app where your focus sessions grow plants.
taman-0.1.1 is not a library.

Taman

ðŸŒą Taman is a TUI Pomodoro productivity app where your focus sessions literally grow plants! Built in Rust with Ratatui, it combines the Pomodoro technique with gamification — complete focus sessions to evolve your plant from a 🌰 seed to a ðŸŠī fully grown plant - all in your terminal!

Buy Me a Coffee at ko-fi.com

Features

[Taman Features]

  • Pomodoro Timer: Configurable focus, short break, and long break durations
  • Plant Growth: Emoji-based plants that grow with each completed session
  • Auto-Run Queue: Queue multiple sessions to run automatically
  • Statistics & Charts: Daily metrics with bar charts and pie charts for productivity insights
  • Themes: Multiple color themes (System, Rose Pine Light, Rose Pine Dark)
  • Persistence: JSON-based saving of progress, stats, and settings
  • Keyboard Navigation: Fully navigable with keyboard only
  • Streak Tracking: Current and longest daily streaks

Installation

From Source

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

From Crates.io

cargo install taman
taman

Usage

Taman is a terminal user interface (TUI) app. Run it and use the following keys:

  • 1/2/3/4: Switch between tabs (Timer, Plant, Stats, Settings)
  • Arrow Keys: Navigate within tabs
  • Enter: Select/activate
  • Space: Start/pause timer
  • s: Stop timer
  • q: Quit

Tabs

  1. âģ Timer: Select session type with arrows, start with Space, stop with s, manage auto-run queue
  2. ðŸŒŋ Plant: View current plant stage and progress
  3. 📊 Stats: Browse daily metrics and charts with arrow navigation
  4. ⚙ïļ Settings: Adjust durations and change themes

Configuration

Settings are saved automatically to ~/.config/taman/data.json (or equivalent on your OS).

  • Focus duration (default: 25 minutes)
  • Short break (default: 5 minutes)
  • Long break (default: 15 minutes)
  • Theme selection

Dependencies

  • Rust 1.70+
  • Terminal with Unicode support

Libraries Used

Contributing

Contributions welcome! Please open issues or pull requests on GitHub.

License

MIT License

Devlogs

  • Devlog #1 - Initial concepts and architecture
  • Devlog #2 - Implementation progress to working prototype
  • Devlog #3 - Crates.io release and community launch

More screenshots

Timer Page Plant Page Stats Page Settings Page

ðŸŒŋ Grow your focus, grow your garden.