README.md

November 24, 2025 · View on GitHub

Catppuccin for Home Assistant

Previews

🌻 Latte

🪴 Frappé

🌺 Macchiato

🌿 Mocha

Usage

With HACS

Note

This will install the default mauve theme shown in the example screenshots. If you wish to have a different highlight color you will need to follow the manual installation steps below.

Add the following code to your configuration.yaml file (reboot required).

frontend:
  ... # your configuration.
  themes: !include_dir_merge_named themes
  ... # your configuration.

Go to the Community Store.
Search for Catppuccin.
Navigate to Catppuccin theme.
Press Install.
Go to Developer Tools, and next Actions. Then select and manually trigger the frontend.reload_actions action.
Go to the Profile General tab and change Theme under Browser Settings to your desired theme.

Manual

Add the following code to your configuration.yaml file (reboot required).

frontend:
  ... # your configuration.
  themes: !include_dir_merge_named themes
  ... # your configuration.

Go to the latest GitHub release
- If you want to install the default (mauve) theme, download the catppuccin.yaml file
- If you want a different highlight color, download and extract the catppuccin-accents.zip file and select the accent(s) you want available
Move the selected file(s) to the themes folder in your HA configuration directory. (E.g. ~/config/themes)
Run the frontend.reload_themes action or restart Home Assistant.
Go to the Profile General tab and change Theme under Browser Settings to your desired theme.

💝 Thanks to

fapfaff