A registry, not a config
Every popup is one row in popups.tsv: name, key, command, size. The quick menu and the direct bindings are generated from it.
tmux plugin
tmux-popups
One row in a table, one popup in tmux.
A Prefix+Enter quick menu and direct bindings, generated from a TSV registry. Add a row, get a popup. Local overrides, dependency checks in the help screen, a doctor script for tmux and TPM problems, and a small or full profile. Bash only, no build step.
For the tmux user who is tired of writing each popup binding by hand.
WHAT YOU CAN DO
Add a row. Get a popup.
Prefix+Enter
The quick menu lists every enabled popup with its key. Press the key to open it over the current pane.
Overrides and a doctor
A local override registry for your own rows, dependency checks in the help screen, and a doctor script for tmux and TPM problems.
GETTING IT
Install with TPM
Add the plugin line
set -g @plugin ‘PatrickFanella/tmux-popups’ in your tmux.conf, then install with TPM.
Pick a profile
Small or full. Enable or disable adapters individually.
Check the dependencies
Each popup needs its own tool. The help screen shows which are present; it checks presence, not credentials.
A FEW DETAILS
Common questions
Does it manage sessions?
No. Session switching is left to tmux-sessionx.
What does it need?
Bash and tmux. Python 3 only for rows that pass JSON arguments.
MADE IN THE OPEN
tmux-popups is made by SUBCULT.
Patreon pays for the hours and the hosting. Paid members get private channels in our Discord and supporter posts, which show up when we have something to share. The monthly newsletter is free.
tmux-popups / BY SUBCULT