https://github.com/ryu-ryuk/time-rs-cli

cli timer written in rust
https://github.com/ryu-ryuk/time-rs-cli

Last synced: 10 months ago
JSON representation

cli timer written in rust

• Host: GitHub
• URL: https://github.com/ryu-ryuk/time-rs-cli
• Owner: ryu-ryuk
• License: mit
• Created: 2025-06-20T12:17:20.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-06-20T13:25:51.000Z (12 months ago)
• Last Synced: 2025-06-20T13:37:25.876Z (12 months ago)
• Language: Rust
• Size: 2.12 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  


    

  

  


    
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 

```sh

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)

```sh

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`](https://github.com/ratatui-org/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 :(

```sh

kitty --override initial_window_width=50c \

      --override initial_window_height=8c \

      ./target/release/timers

```

## ⚙ Build 

```sh

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! 💜