Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork778
💽 Soothing pastel theme for Tmux
License
catppuccin/tmux
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation

Catppuccin forTmux
In order to have the icons displayed correctly please use/update your favoritenerd font.If you do not have a patched font installed, you can override or remove anyicon. Check thedocumentation on theoptions available.
This method is recommended as TPM has some issues with name conflicts.
Clone this repository to your desired location (e.g.
~/.config/tmux/plugins/catppuccin).mkdir -p~/.config/tmux/plugins/catppuccingit clone -b v2.1.3 https://github.com/catppuccin/tmux.git~/.config/tmux/plugins/catppuccin/tmux
Add the following line to your
tmux.conffile:run ~/.config/tmux/plugins/catppuccin/tmux/catppuccin.tmux.Reload Tmux by either restarting or reloading with
tmux source ~/.tmux.conf.
Check out what to do next in the "Getting Started Guide".
InstallTPM
Add the Catppuccin plugin:
set -g @plugin'catppuccin/tmux#v2.1.3'# See https://github.com/catppuccin/tmux/tags for additional tags# ...alongsideset -g @plugin'tmux-plugins/tpm'
(Optional) Set your preferred flavor, it defaults to
"mocha":set -g @catppuccin_flavor'mocha'# latte, frappe, macchiato or mocha
Important
You may have to run~/.config/tmux/plugins/tpm/bin/clean_pluginsif upgrading from an earlier version(especially fromv0.3.0).
This plugin uses features that were only introduced into tmux in version 3.2.If you are using a version earlier than this, you can still have lovelycatppuccin colors, the installation method just looks a little different.
# In your ~/.tmux.conf# Add the colors from the pallete. Check the themes/ directory for all options.# Some basic mocha colors.set -g @ctp_bg"#24273a"set -g @ctp_surface_1"#494d64"set -g @ctp_fg"#cad3f5"set -g @ctp_mauve"#c6a0f6"set -g @ctp_crust"#181926"# status lineset -gF status-style"bg=#{@ctp_bg},fg=#{@ctp_fg}"# windowsset -gF window-status-format"#[bg=#{@ctp_surface_1},fg=#{@ctp_fg}] ##I ##T"set -gF window-status-current-format"#[bg=#{@ctp_mauve},fg=#{@ctp_crust}] ##I ##T"
Breaking changes have been introduced since 0.3, to understand how to migrateyour configuration, see pinned issue#487.
This configuration shows some customisation options, that can be furtherextended as desired.This is what is used for the previews above.
# ~/.tmux.conf# Options to make tmux more pleasantset -g mouse onset -g default-terminal"tmux-256color"# Configure the catppuccin pluginset -g @catppuccin_flavor"mocha"set -g @catppuccin_window_status_style"rounded"# Load catppuccinrun~/.config/tmux/plugins/catppuccin/tmux/catppuccin.tmux# For TPM, instead use `run ~/.tmux/plugins/tmux/catppuccin.tmux`# Make the status line pretty and add some modulesset -g status-right-length 100set -g status-left-length 100set -g status-left""set -g status-right"#{E:@catppuccin_status_application}"set -agF status-right"#{E:@catppuccin_status_cpu}"set -ag status-right"#{E:@catppuccin_status_session}"set -ag status-right"#{E:@catppuccin_status_uptime}"set -agF status-right"#{E:@catppuccin_status_battery}"run~/.config/tmux/plugins/tmux-plugins/tmux-cpu/cpu.tmuxrun~/.config/tmux/plugins/tmux-plugins/tmux-battery/battery.tmux# Or, if using TPM, just run TPM
Copyright © 2021-presentCatppuccin Org
About
💽 Soothing pastel theme for Tmux
Topics
Resources
License
Code of conduct
Contributing
Security policy
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Sponsor this project
Uh oh!
There was an error while loading.Please reload this page.
Uh oh!
There was an error while loading.Please reload this page.




