Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
T

timr-tui

> 编程语言
Open source

TUI to organize your time: Pomodoro, Tabata, Countdown, Timer, Event.

364 stars0 likes1 views
WebsiteGitHub

About

TUI to organize your time: Pomodoro, Tabata, Countdown, Timer, Event.

timr-tui

TUI to organize your time: Pomodoro, Tabata, Countdown, Timer, Event.

  • [1] countdown Use it for your workout, yoga/breathing sessions, meditation, handstand or whatever.
  • [2] timer Check the time on anything you are doing.
  • [3] pomodoro Organize your working time to be focused all the time by following the Pomodoro Technique. Pomodoro becomes Tabata by auto-detection.
  • [4] event Count the time for any event in the future or past.

Table of Contents

  • Preview
  • CLI
  • Keybindings
  • Installation
  • Development
  • Misc
  • Contributing
  • License

Preview

(theme depends on your terminal preferences)

Pomodoro

Tabata (auto-detected)

Timer

Countdown (incl. Mission Elapsed Time)

Event (past/future)

Local time

Local time (footer)

Toggle deciseconds

Maximum (9999y 364d 23:59:59.9)

Change style

Menu

CLI

…

Extra option (if --features sound is enabled by local build only):

bash
--sound                 Path to sound file (.mp3 or .wav) to play as notification. Experimental.

Keybindings

Note: To enable Vim motions key binding, run with --vim=on once. It will be stored as part of settings, so only running once is needed. To disable, run --vim=off.

Menu

Key Description
m Toggle menu

Screens

Key Description
1 Pomodoro
2 Countdown
3 Timer
4 Event
0 Local Time
→ next screen
← previous screen
l next screen (Vim motions)
h previous screen (Vim motions)

Controls

Key Description
space start/stop
r reset
e enter edit mode
q quit

In edit mode only:

Key Description
s save changes
esc skip changes
← or → change selection
h or l change selection (Vim motions)
↑ edit to go up
k edit to go up (Vim motions)
ctrl+↑ edit to go up 10x
ctrl+k edit to go up 10x (Vim motions)
↓ edit to go down
j edit to go down (Vim motions)
ctrl+↓ edit to go down 10x
ctrl+j edit to go down 10x (Vim motions)

In Event edit mode only:

Key Description
enter save changes
esc skip changes
tab switch input

In Pomodoro screen only:

Key Description
ctrl+← or ctrl+→ switch work/pause
ctrl+h or ctrl+l switch work/pause (Vim motions)
a toggle auto switch work/pause
↑ next round
k next round (Vim motions)
↓ previous round
j previous round (Vim motions)
ctrl+↑ increase max rounds
ctrl+k increase max rounds (Vim motions)
ctrl+↓ decrease max rounds
ctrl+j decrease max rounds (Vim motions)
ctrl+r reset rounds
ctrl+s save initial value

In Countdown screen only:

Key Description
ctrl+e edit by local time
ctrl+s save initial value
: toggle finish time

Appearance

Key Description
, toggle styles
. toggle deciseconds
: toggle local time

Installation

Cargo

From crates.io

bash
cargo install timr-tui

From GitHub repository

bash
cargo install --git https://github.com/sectore/timr-tui

Arch Linux

Install from the AUR:

bash
paru -S timr

Nix

Note: Currently timr-tui is available on the unstable channel only.

Command line

bash
# default (w/o sound)
nix-env -iA nixpkgs.timr-tui
# or w/ sound enabled
nix-env -iA nixpkgs.timr-tui --arg timr-tui '(timr-tui.override { enableSound = true; })'

Configuration

nix
# default (w/o sound)
environment.systemPackages = with pkgs; [
  timr-tui
];
# or w/ sound enabled
environment.systemPackages = with pkgs; [
  (timr-tui.override { enableSound = true; })
];

Home Manager

nix
# default (w/o sound)
home.packages = with pkgs; [
  timr-tui
];
# or w/ sound enabled
home.packages = with pkgs; [
  (timr-tui.override { enableSound = true; })
];

Source at nixpkgs:

Release binaries

Pre-built artifacts are available to download from latest GitHub release.

Development

Requirements

Nix users (recommend)

cd into root directory.

If you have direnv installed, run direnv allow once to install dependencies. In other case run nix develop.

Non Nix users

  • Rust
  • Clippy
  • rustfmt
  • dprint
  • just

Commands

…

Build

  • Linux
bash
nix build
# or for bulding w/ statically linked binaries
nix build .#linuxStatic
  • Windows (cross-compilation)
bash
nix build .#windows

Run tests

bash
cargo test

Misc

Persistant app state

Stored on file system:

bash
# Linux
~/.local/state/timr-tui/data/app.data
# macOS
/Users/{user}/Library/Application Support/timr-tui/data/app.data
# Windows
C:/Users/{user}/AppData/Local/timr-tui/data/app.data

Logs

To get log output, start the app by passing --log to timr-tui. See CLI for details.

Logs will be stored in an app.log file at following locations:

bash
# Linux
~/.local/state/timr-tui/logs/app.log
# macOS
/Users/{user}/Library/Application Support/timr-tui/logs/app.log
# `Windows`
C:/Users/{user}/AppData/Local/timr-tui/logs/app.log

Optional: You can use a custom directory by passing it via --log arg.

Contributing

CONTRIBUTING.md

License

MIT License

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rustpomodororatatuirusttabata

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言