Catppuccin for Tmux
- Install TPM
- Add the Catppuccin plugin:
set -g @plugin 'catppuccin/tmux'
# ...alongside
set -g @plugin 'tmux-plugins/tpm'
- (Optional) Set your preferred flavour, it defaults to
"mocha"
:
set -g @catppuccin_flavour 'latte' # or frappe, macchiato, mocha
- Copy your desired theme's configuration contents into your Tmux config (usually stored at
~/.tmux.conf
) - Reload Tmux by either restarting the session or reloading it with
tmux source-file ~/.tmux.conf
All flavours support certain levels of customization that match our Catppuccin Style Guide. 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-right
. With
@catppuccin_window_tabs_enabled
set to on
, the theme will place the
directory within the status-right
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
componenet is set to off.
It can be enabled by specifing any tmux date and time format.
set -g @catppuccin_date_time "%Y-%m-%d %H:%M"
By default, the user
componenet is set to off.
It can be enabled by toggoling it on.
set -g @catppuccin_user "on"
By default, the host
componenet is set to off.
It can be enabled by toggoling it on.
set -g @catppuccin_host "on"
Copyright Β© 2021-present Catppuccin Org