![Logo](https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/logos/exports/1544x1544_circle.png)
Catppuccin for Tmux
Content
Themes
Installation
In order to have the icons displayed correctly please use / update your favorite patched font. If you do not have a patched font installed, you can override or remove any icon. Check the documentation bellow on the options available.
TPM
- 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
Manual
- 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
Overview
This is a diagram on how the theme is split between it's components.
Configuration options
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.
Window
Set the window left separator:
set -g @catppuccin_window_left_separator "β"
Set the window middle separator:
set -g @catppuccin_window_middle_separator "β"
Set the window right separator:
set -g @catppuccin_window_right_separator "β"
Position the number:
set -g @catppuccin_window_number_position "left"
Values:
- left - the number will be on the left part of the window
- right - the number will be on the right part of the window
Enable window status:
set -g @catppuccin_window_status_enable "yes"
Values:
- yes - this will enable the window status part
- no - this will disable the window status part
Enable window status icons instead of text:
set -g @catppuccin_window_status_icon_enable "yes"
Values:
- yes - this will replace the windows status text with icons
- no - this will keep the windows status in text format
Override windows status icons
set -g @catppuccin_icon_window_last "σ°°"
set -g @catppuccin_icon_window_current "σ°―"
set -g @catppuccin_icon_window_zoom "σ°"
set -g @catppuccin_icon_window_mark "σ°"
set -g @catppuccin_icon_window_silent "σ°"
set -g @catppuccin_icon_window_activity "σ°²"
set -g @catppuccin_icon_window_bell "σ°"
Window default
Set the window default color fill:
set -g @catppuccin_window_default_fill "number"
Values:
- number - only the number of the window part will have color
- all - the entire window part will have the same color
- none - the entire window part will have no color
Override the window default text:
set -g @catppuccin_window_default_text "#{b:pane_current_path}" # use "#W" for application instead of directory
Window current
Set the window current color fill:
set -g @catppuccin_window_current_fill "number"
Values:
- number - only the number of the window part will have color
- all - the entire window part will have the same color
- none - the entire window part will have no color
Override the window current text:
set -g @catppuccin_window_current_text "#{b:pane_current_path}" # use "#W" for application instead of directory
Set the current directory format
set -g @catppuccin_window_current_format_directory_text "#{b:pane_current_path}"
Use this to overide the way the current directory is displayed.
Set the directory format
set -g @catppuccin_window_format_directory_text "#{b:pane_current_path}"
Use this to overide the way the directory is displayed.
Status
Set the status module left separator:
set -g @catppuccin_status_left_separator "ξΆ"
Set the status module right separator:
set -g @catppuccin_status_right_separator "β"
Set the status module right separator inverse:
set -g @catppuccin_status_right_separator_inverse "no"
Values:
- yes - the colors will be inverted for the right separator
- no - the colors will not be inverted for the right separator
Set the status connect separator:
set -g @catppuccin_status_connect_separator "yes"
Values:
- yes - the background color of the separator will not blend in with the brackground color of tmux
- no - the background color of the separator will blend in with the brackground color of tmux
Set the status module color fill:
set -g @catppuccin_status_fill "icon"
Values:
- icon - only the icon of the module will have color
- all - the entire module will have the same color
Set the module list
set -g @catppuccin_status_modules_right "application session"
set -g @catppuccin_status_modules_left ""
Provide a list of modules and the order in which you want them to appear in the status.
Available modules:
- application - display the current window running application
- directory - display the basename of the current window path
- session - display the number of tmux sessions running
- user - display the username
- host - display the hostname
- date_time - display the date and time
- battery - display the battery
Customizing modules
Every module (except the module "session") supports the following overrides:
Override the specific module icon
set -g @catppuccin_[module_name]_icon "icon"
Override the specific module color
set -g @catppuccin_[module_name]_color "color"
Override the specific module text
set -g @catppuccin_[module_name]_text "text"
Removing a specific module option
set -g @catppuccin_[module_name]_[option] "null"
This is for the situation where you want to remove the icon from a module. Ex:
set -g @catppuccin_date_time_icon "null"
Battery module
Requirements
This module depends on tmux-battery.
Install
The prefered way to install tmux-battery is using TPM.
Configure
Load tmux-battery after you load catppuccin.
set -g @plugin 'catppuccin/tmux'
...
set -g @plugin 'tmux-plugins/tmux-battery'
Add the battery module to the status modules list.
set -g @catppuccin_status_modules_right "... battery ..."
Create a custom module
It is possible to add a new custom module or overrite any of the existing modules.
Look into custom/README.md for more details.
Any file added to the custom folder will be preserved when updating catppuccin.
Configuration Examples
Below are provided a few configurations as examples or starting points.
Note: When switching bettwen configurations run:
tmux kill-server
In order to kill the tmux server and clear all global variables.
Config 1
set -g @catppuccin_window_right_separator "β "
set -g @catppuccin_window_number_position "right"
set -g @catppuccin_window_middle_separator " | "
set -g @catppuccin_window_default_fill "none"
set -g @catppuccin_window_current_fill "all"
set -g @catppuccin_status_modules_right "application session user host date_time"
set -g @catppuccin_status_left_separator "β"
set -g @catppuccin_status_right_separator "β"
set -g @catppuccin_date_time_text "%Y-%m-%d %H:%M:%S"
Config 2
set -g @catppuccin_window_left_separator "ξΊβ"
set -g @catppuccin_window_right_separator "βξΌ "
set -g @catppuccin_window_number_position "right"
set -g @catppuccin_window_middle_separator " ξΊβ"
set -g @catppuccin_window_default_fill "number"
set -g @catppuccin_window_current_fill "number"
set -g @catppuccin_window_current_text "#{pane_current_path}"
set -g @catppuccin_status_modules_right "application session date_time"
set -g @catppuccin_status_left_separator "ξΆ"
set -g @catppuccin_status_right_separator " ξΆ"
set -g @catppuccin_status_right_separator_inverse "yes"
set -g @catppuccin_status_fill "all"
set -g @catppuccin_status_connect_separator "no"
Config 3
set -g @catppuccin_window_left_separator "ξΆ"
set -g @catppuccin_window_right_separator "ξ΄ "
set -g @catppuccin_window_middle_separator " β"
set -g @catppuccin_window_number_position "right"
set -g @catppuccin_window_default_fill "number"
set -g @catppuccin_window_default_text "#W"
set -g @catppuccin_window_current_fill "number"
set -g @catppuccin_window_current_text "#W"
set -g @catppuccin_status_modules_right "directory user host session"
set -g @catppuccin_status_left_separator " ξΆ"
set -g @catppuccin_status_right_separator "ξ΄"
set -g @catppuccin_status_right_separator_inverse "no"
set -g @catppuccin_status_fill "icon"
set -g @catppuccin_status_connect_separator "no"
set -g @catppuccin_directory_text "#{pane_current_path}"
π Thanks to
Copyright Β© 2021-present Catppuccin Org