🎮 Timepour

A terminal focus timer that turns passing time into a falling tetromino stack.

Timepour makes a focus session feel physical.

Instead of watching a clock tick down, you watch the terminal slowly fill with a deterministic stack of falling blocks. Focus runs glow red. Breaks cool down. When time is up, the board drops into grayscale and the session is over.

Small tool. Strong presence.

Why Timepour

• More vivid than a silent countdown
• Terminal-native and instant to launch
• Deterministic visual progression, not random noise
• Built for short focus rituals, not bloated productivity systems

Install

Timepour is currently git-only. The crates.io release is intentionally pending until the CLI behavior and test coverage are tightened.

cargo install --git https://github.com/Hyena0x/timepour.git --locked

Or build locally:

git clone https://github.com/Hyena0x/timepour.git
cd timepour
cargo build --release --locked

Usage

# 25-minute focus session
timepour start

# 15-minute focus session
timepour start 15

# 5-minute break
timepour break

# 10-minute break
timepour break 10

Controls

• p pause / resume
• q quit
• Esc / Enter exit session

Contributing

Ideas, issues, and PRs are welcome.

License

MIT