2.3 KiB
2.3 KiB
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 |