Time-RS CLI

A minimal Catppuccin-themed TUI countdown timer.

Time-RS CLI is a highly minimal, distraction-free terminal countdown timer.
Built in Rust using ratatui and themed with Catppuccin Mocha.
Perfect for Pomodoros, build pauses, CLI workflows, or just flexing nerdy timers in your terminal.

---

Preview

---

Installation

Install using CURL

curl -sSL https://scripts.alokranjan.me/time-rs-cli/install.sh | bash

Installs the latest prebuilt binary from GitHub Releases.
Currently supports: linux-x86_64

Arch Linux / Manjaro (via AUR)

yay -S timers

you can also use paru or any other AUR helper.

Features

• ⌨️ TUI controls:

  • r — restart timer
  • j/k — add/subtract 10s
  • h — show/hide help
  • esc — close help
  • q — quit
  • p - pomodoro timer
  • m - manual set time

• Catppuccin Mocha theming (colors, borders, text)

• Smart redraws and minimalist centered layout

• Built using ratatui + crossterm

• Single binary, zero dependencies at runtime

Try Kitty Popup Mode

You can use a floating terminal like kitty to simulate a popup view: | Might not work :(

kitty --override initial_window_width=50c \
      --override initial_window_height=8c \
      ./target/release/timers

⚙ Build

git clone https://github.com/ryu-ryuk/time-rs-cli
cd time-rs-cli
cargo build --release
./target/release/timers

🌫 Contributing

I welcome contributions! Whether it's bug fixes, new features, or improvements, feel free to open issues or submit pull requests.

Development Setup

• Fork the repository.

• Clone your fork.

• Create a new branch for your feature or bugfix.

• Make your changes and commit with clear messages.

• Push your branch and open a pull request.

Thank you for helping make Time-RS CLI better! 💜