tmux-contrib/tmux-icon

tmux-icon

Replace tmux window numbers and flags with custom icons and Nerd Font glyphs.

Installation

Add this plugin to your ~/.tmux.conf:

set -g @plugin 'tmux-contrib/tmux-icon'

And install it by running <prefix + I.

Usage

Configure custom icons for window numbers using the @window-index-icons option:

# Circled numbers
set -g @window-index-icons "⓪ ① ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨"

# Square nerd font icons
set -g @window-index-icons "󰎣 󰎦 󰎩 󰎬 󰎮 󰎰 󰎵 󰎸 󰎻 󰎾"

# Any custom characters
set -g @window-index-icons "A B C D E F G H I J"

The plugin automatically replaces #I (window index) patterns in your status bar with the configured icons.

Example Configuration

# Configure custom icons
set -g @window-index-icons "⓪ ① ② ③ ④ ⑤ ⑥ ⑦ ⑧ ⑨"

# Your existing status bar configuration with #I
set -g window-status-format "#I:#W"
set -g window-status-current-format "#I:#W"

# After the plugin loads, #I will display as custom icons

Configuration

| Option | Description | Default | |----------------------|-------------------------------------------------------|---------| | @window-index-icons | Space-separated list of icons for window numbers 0-9 | "" | | @window-flag-icons | Space-separated list of icons for window flags | "" |

Note: The plugin uses opt-in behavior. If these options are not configured (empty default), the plugin does nothing and your tmux options remain unchanged.

Window Flags

The plugin also supports custom icons for window flags using the @window-flag-icons option. Window flags indicate the state of a window:

• - Current window
• - - Last window
• # - Activity in window
• ! - Bell in window
• ~ - Silence in window
• M - Marked window