Catppuccin for Tmux

Content

1. Themes
2. Installation
3. Status line themes
   1. Default
   2. Pill
   3. Powerline
   4. Powerline with icons
   5. No patched fonts
4. Configuration options
   1. Enable window tabs
   2. Configure separators
   3. Enable date and time
   4. Enable user
   5. Enable host
   6. Customize icons

Themes

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

Installation

In order to have the icons displayed correctly please use / update your favorite patched font or overwrite the defaults - refer to Customize icons section. If you do not have patched font installed, you can use the No patched fonts status line theme.

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

Configure separator

By default, the theme will use a round separator. To overwrite it use @catppuccin_l_left_separator, @catppuccin_l_right_separator for left status / window tabs and @catppuccin_r_left_separator, @catppuccin_r_right_separator for right status.

With the default status line theme

set -g @catppuccin_l_right_separator "█"
set -g @catppuccin_r_left_separator "█"

Enable DateTime

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"

Enable User

By default, the user component is set to off. It can be enabled by toggling it on.

set -g @catppuccin_user "on"

Enable Host

By default, the host component is set to off. It can be enabled by toggling it on.

set -g @catppuccin_host "on"

Customize Icons

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"

💝 Thanks to

• Pocco81
• vinnyA3
• rogeruiz

 

Copyright © 2021-present Catppuccin Org