Repolode
Submit
catppuccin

catppuccin/tmux

Soothing pastel Catppuccin color theme for tmux, with four flavors and styled status-line modules.

View on GitHub
Stars
3,213
Forks
837
Open issues
42
Last commit
22 days ago

What is it?

Catppuccin for tmux is a color theme that applies the Catppuccin pastel palette to tmux's status line, windows, and panes. It ships four flavors (Latte, Frappé, Macchiato, and Mocha), and the flavor is selected with a single tmux option.

Beyond colors, the plugin provides configurable status-line modules such as application name, CPU, RAM, session, uptime, and battery, plus options for window status styles like rounded. Many visual elements can be overridden or removed through `@catppuccin_*` variables, which is useful if you do not have a Nerd Font installed.

Installation works by cloning the repository and sourcing `catppuccin.tmux` from your tmux config, or by using TPM. Features that rely on tmux 3.2 or later are noted, and older versions can use manual color variables instead.

Key features

  • 01Four flavors: Latte, Frappé, Macchiato, and Mocha.
  • 02Configurable status-line modules for application, CPU, RAM, session, uptime, and battery.
  • 03Window status styles, including a rounded option.
  • 04Override or remove icons with `@catppuccin_*` variables for users without a patched font.
  • 05Installable manually or through TPM.

Use cases

  • Giving a terminal multiplexer setup a consistent pastel look.
  • Switching between light and dark tmux themes with a flavor option.
  • Adding system stats such as CPU, RAM, and battery to the tmux status bar.

Quick start

  1. 1

    Create the plugin directory

    mkdir -p ~/.config/tmux/plugins/catppuccin
  2. 2

    Clone the repository at the v2.3.2 tag

    git clone -b v2.3.2 https://github.com/catppuccin/tmux.git ~/.config/tmux/plugins/catppuccin/tmux
  3. 3

    Add the run line to your tmux.conf file

  4. 4

    Reload tmux configuration

    tmux source ~/.tmux.conf

Things to know

  • The default installation requires tmux 3.2 or later.
  • Icons need a patched Nerd Font, or you must override or remove them.

In collections

CLI & terminal tools

Topics

#tmux#theme#colorscheme#terminal#catppuccin#status-line#colors#hacktoberfest#tmux-conf#tmux-theme

FAQ

What is tmux?
Soothing pastel Catppuccin color theme for tmux, with four flavors and styled status-line modules. Catppuccin for tmux is a color theme that applies the Catppuccin pastel palette to tmux's status line, windows, and panes. It ships four flavors (Latte, Frappé, Macchiato, and Mocha), and the flavor is selected with a single tmux option.
Is tmux free to use? What license does it have?
tmux is open source under the MIT license. Check the license terms before using it in commercial products.
Is tmux still maintained?
Actively maintained. The last commit to tmux was on Oct 15, 2026.
What can I use tmux for?
Giving a terminal multiplexer setup a consistent pastel look. Switching between light and dark tmux themes with a flavor option. Adding system stats such as CPU, RAM, and battery to the tmux status bar.
How do I install tmux?
Create the plugin directory: mkdir -p ~/.config/tmux/plugins/catppuccin Clone the repository at the v2.3.2 tag: git clone -b v2.3.2 https://github.com/catppuccin/tmux.git ~/.config/tmux/plugins/catppuccin/tmux Add the run line to your tmux.conf file Reload tmux configuration: tmux source ~/.tmux.conf
Where can I get tmux?
The source code and installation instructions are on GitHub: https://github.com/catppuccin/tmux

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects