README.md

June 13, 2026 · View on GitHub

Logo
Catppuccin for Yazi

Previews

🌻 Latte
🪴 Frappé
🌺 Macchiato
🌿 Mocha

Usage

  1. Copy the theme file of your choice from themes/ to your Yazi configuration directory with the filename theme.toml.
  2. For Catppuccin-themed syntax highlighting in the preview pane:
    • Download the .tmTheme file of your choice from catppuccin/bat.
    • Set the syntect_theme option of your theme file downloaded in step 1 with the path of your downloaded .tmTheme file.

Contributing

To contribute to this port you will need the following dependencies installed:

Edit yazi.tera to make changes to the theme. Run just build to build the output themes in themes/.

Icons

To avoid refetching the icon rule metadata every time we rebuild the themes, icon data is saved in icons.json and updated when necessary.

To update the icons data, you will additionally need Lua, LuaRocks, and the dkjson LuaRocks module. Run the ./update_icons.sh script to fetch and process the data from nvim-web-devicons.

💝 Thanks to

 

Copyright © 2021-present Catppuccin Org