https://github.com/joshmedeski/tmux-nerd-font-window-name
Nerd Font icons for your tmux windows
https://github.com/joshmedeski/tmux-nerd-font-window-name
Last synced: about 1 month ago
JSON representation
Nerd Font icons for your tmux windows
- Host: GitHub
- URL: https://github.com/joshmedeski/tmux-nerd-font-window-name
- Owner: joshmedeski
- Created: 2023-01-06T15:51:21.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-08-04T14:53:22.000Z (3 months ago)
- Last Synced: 2025-08-04T18:32:02.921Z (3 months ago)
- Language: Shell
- Size: 1.59 MB
- Stars: 178
- Watchers: 2
- Forks: 31
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-tmux - tmux-nerd-font-window-name
README
# tmux nerd font window name plugin
Automatically add Nerd Font support to your tmux window names!
## Requirements
The following dependencies are required in order to use this plugin:
- [tmux](https://github.com/tmux/tmux)
- [tpm](https://github.com/tmux-plugins/tpm)
- [yq](https://github.com/mikefarah/yq) (>=4)
## Installation (via tpm)
Add the following line to your tmux configuration file:
```sh
set -g @plugin 'joshmedeski/tmux-nerd-font-window-name'
```
Run `+I` to trigger the tpm installer which will download
and source the plugin.
## Configuration
You can configure this plugin by creating a `~/.config/tmux/tmux-nerd-font-window-name.yml`
file. The following options can be changed:
```yml
config:
fallback-icon: "?" # show when no definition is found
multi-pane-icon: "" # show when window has multiple panes (blank by default)
show-name: true # show the window name with the icon (defaults to false)
icon-position: "left" # show the icon to the "left" or "right" of the window name (defaults to left)
icons:
zsh: "" # overwrite with your own symbol (Nerd Font icon, emoji, whatever!)
cmatrix: "🤯" # add new entries that aren't included
```
## Contributions
Contributions are welcome! Feel free to make a pull request to submit more
preset icon settings or improve the codebase!
## Intro Video
Here is the introduction blog post and video that I made for this plugin:
[](https://www.joshmedeski.com/posts/tmux-nerd-font-window-name-plugin/)
## Additional tmux plugins
I've authored a few other tmux plugins that you might find useful:
- [sesh - tmux session manager](https://github.com/joshmedeski/sesh)
- [tmux-fzf-url - Quickly open urls with fzf](https://github.com/joshmedeski/tmux-fzf-url)