百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
T

timr-tui

> 编程语言
开源

TUI 可帮您组织时间: Pomodoro、Tabata、倒计时、计时器、事件。

364 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

TUI 可帮您组织时间: Pomodoro、Tabata、倒计时、计时器、事件。

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 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rustpomodororatatuirusttabata

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

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