Catppuccin for Tmux
⚠️ This is a custom fork of the original catppuccin theme
- Install TPM
- Add the Catppuccin plugin:
set -g @plugin 'pauchiner/catppuccin-theme'
# ...alongside
set -g @plugin 'tmux-plugins/tpm'
the theme support certain levels of customization, To add these customizations, add any of the following options to your Tmux configuration.
⚠️ In order to have the correct icons displayed please use your favorite nerd fonts patched font.
By default, the theme places the window-status
in the status-left
. With
@catppuccin_window_tabs_enabled
set to on
, the theme will place the
directory within the status-left
and move the window names to the
window-status
format variables.
set -g @catppuccin_window_tabs_enabled on # or off to disable window_tabs
By default, the theme will use a round separator for left and right.
To overwrite it use @catppuccin_left_separator
and @catppuccin_right_separator
set -g @catppuccin_left_separator "█"
set -g @catppuccin_right_separator "█"
By default, the date_time
component is set to off.
It can be enabled by specifying any tmux date and time format.
set -g @catppuccin_date_time "%Y-%m-%d %H:%M"
By default, the user
component is set to off.
It can be enabled by toggling it on.
set -g @catppuccin_user "on"
By default, the host
component is set to off.
It can be enabled by toggling it on.
set -g @catppuccin_host "on"
Each of the components comes with their own default icon, which can be changed to fit your preference or requirements of your font.
Note: NerdFont Icons do not render properly in the Github UI, so the below example does not use them
set -g @catppuccin_datetime_icon "A"
set -g @catppuccin_user_icon "B"
set -g @catppuccin_directory_icon "C"
set -g @catppuccin_window_icon "D"
set -g @catppuccin_session_icon "E"
set -g @catppuccin_host_icon "F"
Copyright © 2021-present Catppuccin Org