/tmux-nerd-font-window-name

Nerd Font icons for your tmux windows

Primary LanguageShell

thumbnail

tmux nerd font window name plugin

Automatically rename your tmux windows to Nerd Font Icons.

Prerequisites

How to install

Install tpm plugin

This script can be installed with the Tmux Plugin Manager (tpm).

Add the following line to your ~/.tmux.conf file:

set -g @plugin 'joshmedeski/tmux-nerd-font-window-name'

Options

Add the following options to your tmux.conf before you set the plugin.

# shows the window name next to the icon (default false)
set -g @tmux-nerd-font-window-name-show-name true

Minimalist format

If you want a minimalist format and only show the nerd font icon. You can update your window status to just #W (window name) in your tmux config.

set -g window-status-current-format '#[fg=magenta]#W'
set -g window-status-format         '#[fg=gray]#W'

Customize icons

To specify a custom icon for your editor, music player, shell, and for unknown programs, use the following option to set any icon you prefer:

set -g @tmux-nerd-font-window-name-shell-icon "" # Shell
set -g @tmux-nerd-font-window-name-music-icon "󰝚" # Music
set -g @tmux-nerd-font-window-name-editor-icon "󰨞" # Editor
set -g @tmux-nerd-font-window-name-editor-enable-all true # Apply to all editors (above setting only applies to editors that are not Vim or Emacs)
set -g @tmux-nerd-font-window-name-git-icon "" # Git
set -g @tmux-nerd-font-window-name-fallback-icon "󰒓" # Unknown programs

How it works

When installed, your window names will automatically update to a Nerd Font that matches the activity (ex: vim, bash, node, ect...).

Tasks

  • Create tpm plugin

Contributing

I encourage contributors! I want to make this plugin the best it can be. Feel free to fork it and submit pull requests with any new ideas or improvements you have.