๐Ÿ… TUI Pomodoro App

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

  2. Configure session length (e.g., 25 minutes of focus)

  3. โ–ถ๏ธ Start / โน๏ธ Stop Timer

  4. Manual control over timer execution

  5. Designed for single-session focus tracking

  6. ๐Ÿง˜ Minimal Interface

  7. Clean and distraction-free

  8. Suitable for full-screen terminal use

๐Ÿ–ผ๏ธ Demo

{{ img(src = "/media/tui_pomodoro_app.gif") }}


๐Ÿ“ฆ Installation & Usage

  1. Clone the Repository

bash git clone https://github.com/maltsev-dev/tui_pomodoro cd tui_pomodoro

  1. Build the Project

bash cargo build --release

  1. Run the Application

bash 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.