/tmux-prefix-highlight

Plugin that highlights when you press tmux prefix key

Primary LanguageShellMIT LicenseMIT

Tmux prefix highlight

NOTE: This project is no longer in active development. Bugs and features requests won't get implemented by the project maintainers. We still welcome discussions and community pull requests, though.

Looking for Maintainer: I haven't been using TMUX for a while now and I feel like I'm not serving the comunity well by being the maintainer of this plugin. If you're interested in maintaning this plugin, please reach out.


Plugin that highlights when you press tmux prefix key. Inspired by this thread on stackoverflow.

Many thanks to @obxhdx for showing me this trick.

Prefix off: prefix_off

Prefix on: prefix_on

Usage

Just add #{prefix_highlight} to your left/right status bar.

set -g status-right '#{prefix_highlight} | %a %Y-%m-%d %H:%M'

The plugin can also be configured to show when copy mode is active; see the Configurations section for details.

Installation with Tmux Plugin Manager (recommended)

Add plugin to the list of TPM plugins:

set -g @plugin 'tmux-plugins/tmux-prefix-highlight'

Press prefix + I to install it.

Manual Installation

Clone the repo:

$ git clone https://github.com/tmux-plugins/tmux-prefix-highlight.git ~/clone/path

Add this line to your .tmux.conf:

run-shell ~/clone/path/prefix_highlight.tmux

Reload TMUX environment with:

$ tmux source-file ~/.tmux.conf

Configurations

The colors used for the prefix highlight can be configured:

set -g @prefix_highlight_fg 'white' # default is 'colour231'
set -g @prefix_highlight_bg 'blue'  # default is 'colour04'

The plugin can also be configured to show when copy or synchronized panes mode is active. If enabled, the #{prefix_highlight} token will be replaced with the string Copy when copy mode is enabled and Sync for synchronized panes. The style for copy and sync mode can be configured as a comma-separated list of colors and attributes:

set -g @prefix_highlight_show_copy_mode 'on'
set -g @prefix_highlight_copy_mode_attr 'fg=black,bg=yellow,bold' # default is 'fg=default,bg=yellow'
set -g @prefix_highlight_show_sync_mode 'on'
set -g @prefix_highlight_sync_mode_attr 'fg=black,bg=green' # default is 'fg=default,bg=yellow'

The prefix, copy and sync prompts can also be configured:

set -g @prefix_highlight_prefix_prompt 'Wait'
set -g @prefix_highlight_copy_prompt 'Copy'
set -g @prefix_highlight_sync_prompt 'Sync'

Additionally, the plugin can be configured to attach optional affixes to the value contained in #{prefix_highlight}. (e.g. < ^B >)

set -g @prefix_highlight_output_prefix '< '
set -g @prefix_highlight_output_suffix ' >'

The empty (shown when prefix is off) prompt and attribute can be configured, It is useful for aligning segments.

set -g @prefix_highlight_empty_prompt '        '          # default is '' (empty char)
set -g @prefix_highlight_empty_attr 'fg=default,bg=green' # default is 'fg=default,bg=default'

Defaultly, empty prompt can't be attached optional affixes. If you want attach affixes on empty prompt, config @prefix_highlight_empty_has_affixes to on.

set -g @prefix_highlight_empty_has_affixes 'on' # default is 'off'
set -g @prefix_highlight_empty_prompt 'Tmux'
set -g @prefix_highlight_output_prefix '< '
set -g @prefix_highlight_output_suffix ' >'

License

MIT