Catppuccin for Tmux

Themes

• 🌻 Latte
• 🪴 Frappé
• 🌺 Macchiato
• 🌿 Mocha

Usage

TPM

1. Install TPM
2. Add the Catppuccin plugin:

set -g @plugin 'catppuccin/tmux'
# ...alongside
set -g @plugin 'tmux-plugins/tpm'

3. (Optional) Set your preferred flavour, it defaults to "mocha":

set -g @catppuccin_flavour 'latte' # or frappe, macchiato, mocha

Manual

1. Copy your desired theme's configuration contents into your Tmux config (usually stored at ~/.tmux.conf)
2. Reload Tmux by either restarting the session or reloading it with tmux source-file ~/.tmux.conf

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.

Enable window tabs

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

Configure separator

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 "█"

💝 Thanks to

• Pocco81
• vinnyA3
• rogeruiz

 

Copyright © 2021-present Catppuccin Org