Skip to main content

Catppuccin Theme

A popular modern theme for the tmux status bar with four color flavors and extensive customization options.

Status on This Server

Not installed. Optional plugin.

Installation

~/.tmux.conf
set -g @plugin 'catppuccin/tmux'

Then press Ctrl+Space I to install.

Configuration

~/.tmux.conf
# Color flavor: latte, frappe, macchiato, mocha
set -g @catppuccin_flavor 'mocha'

# Window status style
set -g @catppuccin_window_status_style 'rounded'

# Enable modules
set -g @catppuccin_date_time '%H:%M'

Flavors

FlavorStyle
latteLight theme (high contrast)
frappeSoft warm tones
macchiatoMedium dark
mochaDarkest (this server's preference)

Modules

The theme supports modular status bar components: session name, window index, date/time, battery, git status, and more. Each module can be enabled or disabled independently.