#tmux #statusbar #icons #nerdfonts #stausline

app despell

despell puts icons in your tmux statusline

2 stable releases

1.0.1 Jul 24, 2023
1.0.0 Jul 16, 2023

#348 in Text processing

26 downloads per month

MIT license

361 lines

despell maps commands to icons in tmux's status line


  • πŸ—ΊοΈ Map commands to nerdfont icons
  • 🎨 Customization options for colors and emojis
  • πŸ”„ Easy to override default mappings
  • ⚑ Fast (Instant lookup time O(1))
  • πŸ”§ Simple to use and integrate with other themes



cargo install despell

Note Make sure that $HOME/.cargo/bin is in your PATH environment variable


despell requires your terminal to use a Nerd Fonts-patched font.

How does it work?

At its core, despell takes a string (process name) as input and returns a string (icon) as output.

Getting started

To use despell in your existing config, replace all occurrences of



#(despell #W) #W

in your ~/.tmux.conf.

If you don't have a ~/.tmux.conf yet, have a look at the example configs below to get started.

Example config

You can start using despell by using the example config from the screenshot. Copy of the config below into your own ~/.tmux.conf to get started.


set-window-option -g window-status-separator ''

set-option -g status-style bg=$tmux_statusbar_bg
set-option -g status-left ""
set-option -g status-right ""

set -g status-justify centre

set-window-option -g window-status-current-format "\
#[bg=$tmux_active_bg] #(despell -c #W)\
#[fg=$tmux_active_fg bg=$tmux_active_bg] #W "

set-window-option -g window-status-format "\
#[fg=$tmux_inactive_fg,bg=$tmux_statusbar_bg] #(despell -c #W)\
#[fg=$tmux_inactive_fg,dim bg=$tmux_statusbar_bg] #W "


Center alignment

To center the status line instead of left aligned (default), add the following command to your ~/.tmux.conf:

set -g status-justify centre

Update frequency

To configure how often tmux refreshes its status line, add the following command to your ~/.tmux.conf:

set -g status-interval 5

Per-icon colors

To let despell set the icon color and override your theme settings, run despell with the -c or --color flag:

#(despell -c #W)


To use emojis instead of Nerd Fonts, run despell with the -e or --emoji flag:

#(despell -e #W)

Overriding and adding icons

To override any of the default mappings, run despell with the -u or --custom flag. Place a config.toml in ~/.config/despell/config.toml with your custom mappings.

All fields are optional, so if you don't use emojis, you can safely omit the fields from the TOML.

nerdfont = "β—’"
color = "none"
emoji = "🐠"

nerdfont = "β—‡"
color = "blue"
emoji = "🌐"

nerdfont = "❀"
color = "magenta"
emoji = "πŸ’™"

Is a mapping missing?

Let me know by opening an Issue, Discussion or PR.


~51K SLoC