Catppuccin for GTK

About

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

Usage

Requirements

GTK >=3.20
gnome-themes-extra (or gnome-themes-standard)
Murrine engine

Installation

Download and extract the Catppuccin-Flavour.zip file. or Catppuccin-Flavour-Color.zip file. From Release or you can install the theme from the AUR
Move the theme folder to ".themes" in your home directory. (~/.themes) (Skip this step if you are using the AUR package)
Select "Catppuccin-Flavour or Catppuccin-Flavour-Color" via your desktop specific tweaks application (gnome-tweaks on Gnome3+).

For Flatpak users

To give your Flatpaks access to your themes folder run:

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

To set the theme for all Flatpaks, replace ##theme## with the name of the theme you want to use and run this command:

sudo flatpak override --env=GTK_THEME=##theme##

For a more in depth tutorial see Hamza Algohary's tutorial on It's Foss

For Arch Linux users

We have 4 AUR packages for all the 4 flavours of the theme:

With your favourite AUR helper, install them:

yay -S catppuccin-gtk-theme-mocha catppuccin-gtk-theme-macchiato catppuccin-gtk-theme-frappe catppuccin-gtk-theme-latte

Development

Note: Ensure that you have atleast python version 3.10 installed

Clone the repository using

git clone --recurse-submodules git@github.com:npv12/gtk.git

To check out the install script, run

python install.py --help

You can install any theme like the following example

python install.py mocha -a sky --tweaks rimless -d ~/.themes

You can build all possible variations of the theme possible using the following command and it will output it to releases folder in the root of the repo.

python build.py

A few important notes to keep in mind

recolor.py handles all changes that needs to be done to colloid to ensure it generated catppuccin colors. If vinceliuice changes anything in his theme in future, that is where you must change
ctp_colors.py includes all catppuccin colors and accent. If any colors beside accent is included, ensure it is changed in get_accent as well.
var.py includes all different variables that you can tinker around as per your personal requirements.
create_theme.py consists of a wrapper that will recolor the colloid theme, install it as per the args provided and rename it accordingly.

ss77a/gtk