← All extensions

Catppuccin Blur

v0.4.0 · by Jens Lystad · added 3 November 2026

Catppuccin themes with blur

Themes
Install in Forge SuperView the source

How to install

With Forge Super installed, the button above opens the app on this extension, where you press Install. Nothing is installed until you do.

You can also open the Extensions panel in the app and search for Catppuccin Blur. The extension's id is catppuccin-blur.

Don't have Forge Super yet? Download it here.

README

From the extension's repository, written by its authors and not by Mentenaz. See the source.

🌿 Catppuccin Blur for Zed

Note The blur effect may not work on all operating systems. This is a limitation of Zed's window transparency implementation, not a theme issue. If you experience issues with blur, please report them to the Zed repository.

Note This is an opinionated fork of the original Catppuccin theme. In addition to the blur effects, it includes various UI tweaks and modifications to create a unique visual experience. The changes go beyond just adding transparency.

📸 Previews

📦 Installation

  1. Clone this repository to your local machine
  2. Open the Extensions panel in Zed, click "Install Dev Extension" and select the cloned repository folder

⚙️ Recommended Settings

For the best experience with this theme, add the following to your Zed settings:

{
  "project_panel": {
    "sticky_scroll": false
  }
}

This disables sticky scroll in the project panel, which can interfere with the blur effect on the panel overlays.

🎨 Recommended Icon Theme

For a cohesive visual experience, we recommend installing the Catppuccin Icons extension alongside this theme. The icon colors are specifically designed to complement the Catppuccin color palette.

🔧 Development

Syncing with Upstream

This theme is kept in sync with the official Catppuccin theme using the sync_theme.py script. The script:

  1. Fetches the latest theme from the official Catppuccin repository
  2. Applies blur-specific overrides defined in theme_overrides.py
  3. Generates the final theme file

Important: Do not manually edit themes/catppuccin-blur.json directly. All customizations should be made in the theme_overrides.py file. Any manual changes to the JSON file will be overwritten when the sync script runs.

To update the theme:

python3 sync_theme.py

Making Theme Customizations

To customize the theme, edit the THEME_OVERRIDES dictionary in theme_overrides.py. Each variant (latte, iced_latte, frappe, macchiato, mocha, espresso) has its own set of overrides. For example:

"latte": {
    "background": "#f9fafcd7",
    "panel.overlay_background": "#f9fafc",
    # Add more overrides here
}