Catppuccin for GTK

This GTK theme is based on the Colloid theme made by vinceliuice

Usage

Requirements

• GTK >=3.20
• python3
• gnome-themes-extra (or gnome-themes-standard)

To build the theme, make sure the following packages are installed:

• sassc
• inkscape
• optipng

Manually

1. Download and extract the theme zip from the latest release.
2. Move the theme folder to the ~/.local/share/themes directory.
3. Select the downloaded theme via your desktop specific tweaks application (GNOME Tweaks on GNOME 3+).
4. To theme other apps that are using GTK, make sure to run the following command:

export THEME_DIR="~/.local/share/themes/catppuccin-<flavor>-<accent>-standard+default"
mkdir -p "${HOME}/.config/gtk-4.0" && 
ln -sf "${THEME_DIR}/gtk-4.0/assets" "${HOME}/.config/gtk-4.0/assets" &&
ln -sf "${THEME_DIR}/gtk-4.0/gtk.css" "${HOME}/.config/gtk-4.0/gtk.css" &&
ln -sf "${THEME_DIR}/gtk-4.0/gtk-dark.css" "${HOME}/.config/gtk-4.0/gtk-dark.css"

Flatpak

In order for Flatpak to access the theme, make sure to run the following command:

sudo flatpak override --filesystem=$HOME/.local/share/themes

Then, run the following command to apply the theme.

export THEME_DIR="~/.local/share/themes/catppuccin-<flavor>-<accent>-standard+default"
sudo flatpak override --env=GTK_THEME=$THEME_DIR

Using the install script to install the theme

To install the theme using the install script, run install.py:

python3 install.py <flavor> <accent>

If you have adwaita installed, make sure to include --link in order to add symlinks for it:

python3 install.py <flavor> <accent> --link

Run the command and the gtk theme should be installed!

AUR

We have 4 AUR packages for all the 4 flavours (Latte, Frappe, Macchiato, Mocha)

With your favourite AUR helper, you can install one of these flavors:

yay -S catppuccin-gtk-theme-<flavor>

Nix

We suggest you use catppuccin/nix. Alternatively, you can use catppuccin-gtk from nixpkgs.

{inputs, ...}: {
  imports = [inputs.catppuccin.homeManagerModules.catppuccin];

  gtk = {
    enable = true;
    catppuccin = {
      enable = true;
      flavor = "mocha";
      accent = "pink";
      size = "standard";
      tweaks = [ "normal" ];
    };
  };
}

Tip

For further information on the options available, see the full documentation.

For Other Distros

Refer to Using the install script to install the theme or Installing the theme manually.

Theming the GDM Theme

In order to theme the GDM theme, install the gdm-settings app, select the Catppuccin theme, and click Save.

💝 Thanks to

Current maintainers

• npv12
• ghostx31
• Syndrizzle

Contributions

• rubyowo - CI and docs
• braheezy - Instructions for the GDM theme

Previous maintainer(s)

• sadrach-cl

 

Copyright © 2021-present Catppuccin Org