A terminal-based Pomodoro timer built with Rust and Cursive, replicating the feel of vintage console tools.
cursive Version


โณ Text-based User Interface Pomodoro Timer

๐Ÿ“š GitHub Repository

This project is an experimental implementation of the Pomodoro Technique in a text-based user interface, leveraging the cursive crate to build a clean, keyboard-navigated experience in the terminal.

Ideal for Rust developers looking to:

  • Practice TUI development
  • Create distraction-free productivity tools
  • Understand timer-based logic in async or event-driven environments

โš™๏ธ Tools & Tech

Tools

Rust Version cursive Version Build Status


โœจ Features

  1. โฒ๏ธ Set Custom Timer

    • Configure session length (e.g., 25 minutes of focus)
  2. โ–ถ๏ธ Start / โน๏ธ Stop Timer

    • Manual control over timer execution
    • Designed for single-session focus tracking
  3. ๐Ÿง˜ Minimal Interface

    • Clean and distraction-free
    • Suitable for full-screen terminal use

๐Ÿ–ผ๏ธ Demo


๐Ÿ“ฆ Installation & Usage

  1. Clone the Repository

    git clone https://github.com/maltsev-dev/tui_pomodoro
    cd tui_pomodoro
    
  2. Build the Project

    cargo build --release
    
  3. Run the Application

    cargo run
    

Use arrow keys to navigate the TUI and manage your Pomodoro sessions.


๐Ÿ“„ License

This project is open-source under the MIT License โ€” use, modify, and distribute freely.