GitHunt
JA

javAlborz/tmux-vision-timer

tmux-vision-timer

A minimal tmux timer for the 20-20-20 rule: every 20 minutes, look at something 20 feet away for 20 seconds.

⏱ → 👁 → repeat

Install

# Add to ~/.tmux.conf
set -g @plugin 'javAlborz/tmux-vision-timer'
set -g status-right '#{simple_timer_status} %H:%M'

Press prefix + I to install via TPM.

Use

Key Action
prefix + e Start / Restart
prefix + E Cancel

Configure

set -g @simple_timer_mins 20       # duration
set -g @simple_timer_on ""       # running
set -g @simple_timer_done "👁 "    # complete

License

MIT

Languages

Shell100.0%

Contributors

MIT License
Created December 8, 2025
Updated December 8, 2025