
Catppuccin for Hyprland
Important
Since Hyprland 0.55, Hyprland configuration is done in Lua.
For the legacy .conf format, please visit and follow the instructions on the v1.3 tag.
- Download the theme for your desired flavour, e.g.
catppuccin-mocha.lua(from the release or fromthemes/lua/after cloning) - Copy it into your Hyprland config, e.g.
~/.config/hypr/themes/catppuccin-mocha.lua - Load it from your
hyprland.lua
local colors = require('themes.catppuccin-mocha')- Use colors
-- Non-alpha values are already in Hyprland's rgb(...) format.
local base = colors.base
-- Alpha values are hex without transparency; append the alpha, eg. `ee` and wrap in rgba(...).
local surface0_ee = rgba(colors.surface0Alpha .. 'ee')- Q: "Hyprland doesn't work with the colors"
A: Make sure you are loading the correct theme file for your Hyprland version (.luafor >= 0.55) and referencing the values correctly (e.g.colors.base).
Copyright © 2021-present Catppuccin Org




