Tmux Indicators

Plugin that allows you to customize and configure indicators for your tmux session.

Usage

You can add Tags to the status-left and/or status-right options for your status bar.

The following tags are available to use:

Tag	Description
#{prefix}	Prefix Indicator
#{synchronized}	Synchronized Indicator
#{sharedsession}	Shared Sessions Indicator

Examples:

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

Installation with Tmux Plugin Manager (recommended)

Add the plugin to the list of TPM plugins:

set -g @plugin 'https://git.linux-help.org/psi-jack/tmux-indicators'

Press prefix+I to install it.

Manual Installation

Clone the repo:

$ git clone https://git.linux-help.org/psi-jack/tmux-indicators ~/clone/path

Add this line to your .tmux.conf:

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

Reload TMUX environment with:

tmux source-file ~/.tmux.conf

Configurations

Configuring the various options can be done by setting the various settings in your tmux configuration with:

set -g "setting" "value"

And the following settings are available for each tag:

Setting	Description	Default
@prefix_text	Text for prefix indicator	"⌨️ "
@prefix_fg	Prefix foreground color
@prefix_bg	Prefix background color
@prefix_attr	Prefix attribute options
@synchronized_text	Text for synchronized indicator	"🔁 "
@synchronized_fg	Synchronized foreground color
@synchronized_bg	Synchronized background color
@synchronized_attr	Synchronized attribute options
@sharedsession_text	Text for Shared Sessions indicator	"👓 "
@sharedsession_fg	Shared Sessions foreground color
@sharedsession_bg	Shared Sessions background color
@sharedsession_attr	Shared Sessions attribute options

License

MIT