Catppuccin ZSH Theme

A clean, informative ZSH theme tailored for the Catppuccin color palette. Based on the steeef theme from Oh My Zsh, adapted to strictly use Catppuccin hex colors for prompts with several usability improvements.

Available in four flavors: Latte (light), Frappé (medium), Macchiato (medium), and Mocha (dark).

Features

• Catppuccin Colors: Native Catppuccin hex color integration for prompts. Each flavor uses its own color palette so the theme blends seamlessly with your Catppuccin terminal setup.
• VCS / Git Status: Displays the current branch, staged/unstaged changes, and untracked files.
• Smart Hostname: The @hostname is hidden for local sessions to save space and only shown when connected via SSH.
• Path Truncation: Limits the working directory display to the last 3 directories (%3~) to keep the prompt clean in deep directory structures.
• Virtualenv Support: Displays the active Python virtual environment.

Preview

The prompt looks like this:

username in ~/path/to/project (branch●) (venv)
$

Color Mapping

Element	Catppuccin Color
Username	Mauve
Hostname (SSH)	Peach
Path	Green
Branch name	Teal
Staged ●	Green
Unstaged ●	Peach
Untracked ●	Maroon
Virtualenv	Lavender
Prompt text	Text

Installation

You can install the theme either automatically via the provided interactive script, or manually.

Option 1: Automatic Installation (Interactive)

Run the following command in your terminal. The script will ask you which flavor you want to install:

curl -fsSL https://raw.githubusercontent.com/moinferdi/catppuccin-zsh/main/themes/install.sh | bash

Option 2: Manual Installation

1. Download the desired theme flavor to your Oh My Zsh custom themes directory.

   Latte:

   curl -o ~/.oh-my-zsh/custom/themes/catppuccin-latte.zsh-theme https://raw.githubusercontent.com/moinferdi/catppuccin-zsh/main/themes/catppuccin-latte.zsh-theme

   Frappé:

   curl -o ~/.oh-my-zsh/custom/themes/catppuccin-frappe.zsh-theme https://raw.githubusercontent.com/moinferdi/catppuccin-zsh/main/themes/catppuccin-frappe.zsh-theme

   Macchiato:

   curl -o ~/.oh-my-zsh/custom/themes/catppuccin-macchiato.zsh-theme https://raw.githubusercontent.com/moinferdi/catppuccin-zsh/main/themes/catppuccin-macchiato.zsh-theme

   Mocha:

   curl -o ~/.oh-my-zsh/custom/themes/catppuccin-mocha.zsh-theme https://raw.githubusercontent.com/moinferdi/catppuccin-zsh/main/themes/catppuccin-mocha.zsh-theme

2. Open your ZSH configuration file:

   vim ~/.zshrc

3. Set the ZSH_THEME variable to the flavor you downloaded:

   ZSH_THEME="catppuccin-latte"
   # or
   ZSH_THEME="catppuccin-frappe"
   # or
   ZSH_THEME="catppuccin-macchiato"
   # or
   ZSH_THEME="catppuccin-mocha"

4. Save the file and apply the changes:

   source ~/.zshrc

Requirements

• Oh My Zsh
• A terminal emulator configured with a Catppuccin color scheme for the best visual experience.

License

This project is licensed under the MIT License.