# v25.11 - Better late than never... again Hello all, after a long wait our 25.11 release has been made! Thanks for bearing with us <3 So what does this mean for you? If your would like to use the stable nixpkgs/home-manger releases then we highly suggest you pin this repo to the `release-25.11` branch. # Changelog In this release we witnessed the creation of 7 new modules and the continued bug fixes and support for our other supported modules. ## [25.11](https://github.com/catppuccin/nix/releases/tag/v25.11) - 2026-01-06 ### 🚨 Breaking Changes - **modules**: drop support for nixpkgs 24.11 by [@getchoo](https://github.com/getchoo) ### 🚀 Features - **home-manager**: add support for halloy by [@isabelroses](https://github.com/isabelroses) - **home-manager**: add support for vivid by [@Anomalocaridid](https://github.com/Anomalocaridid) - **home-manager**: add support for eza by [@ryanccn](https://github.com/ryanccn) - **home-manager**: add support for television by [@isabelroses](https://github.com/isabelroses) - **home-manager**: support vicinae by [@isabelroses](https://github.com/isabelroses) - **home-manager**: add support for anki by [@musjj](https://github.com/musjj) - **home-manager/qutebrowser**: add plainLook option by [@SchweGELBin](https://github.com/SchweGELBin) - **nixos**: add support for cursors and icons by [@musjj](https://github.com/musjj) - **wezterm**: set flavor and accent as plugin options by [@signegrau](https://github.com/signegrau) ### 🐛 Bug Fixes - **global**: use `extra-*` for cache settings by [@musjj](https://github.com/musjj) - **home-manager**: import halloy by [@isabelroses](https://github.com/isabelroses) - **home-manager/cava**: remove ifd by [@Anomalocaridid](https://github.com/Anomalocaridid) - **home-manager/delta**: use new options by [@alapshin](https://github.com/alapshin) - **home-manager/eza**: remove IFD by [@ryanccn](https://github.com/ryanccn) - **home-manager/eza**: enable only if enabled in home-manager by [@SymphonySimper](https://github.com/SymphonySimper) - **home-manager/foot**: update port for v1.22.3 by [@aciceri](https://github.com/aciceri) - **home-manager/freetube**: fix theme setting formatting by [@Anomalocaridid](https://github.com/Anomalocaridid) - **home-manager/kvantum**: remove platform theme assertion by [@musjj](https://github.com/musjj) - **home-manager/mako**: remove ifd by [@Anomalocaridid](https://github.com/Anomalocaridid) - **home-manager/sioyek**: remove ifd by [@Anomalocaridid](https://github.com/Anomalocaridid) - **home-manager/television**: installed without enable option by [@isabelroses](https://github.com/isabelroses) - **nixos/gitea**: Explicitly create directories with forge user/group by [@aveeryy](https://github.com/aveeryy) - **pkgs/buildcatppuccinport**: failing meta checks by [@KP64](https://github.com/KP64) - **vscode**: flakey builds by [@isabelroses](https://github.com/isabelroses) ### 📚 Documentation - **README**: update website links by [@getchoo](https://github.com/getchoo) - clean up and add release branch guides by [@getchoo](https://github.com/getchoo) - add 25.05 changelog by [@getchoo](https://github.com/getchoo) - theme code blocks by [@getchoo](https://github.com/getchoo) - move most content from repo to site by [@getchoo](https://github.com/getchoo) - Update obsolete flake attribute for importing catppuccin by [@MonsterDruide1](https://github.com/MonsterDruide1) ### New Contributors * [@KP64](https://github.com/KP64) made their first contribution in [#789](https://github.com/catppuccin/nix/issues/789) * [@MonsterDruide1](https://github.com/MonsterDruide1) made their first contribution in [#710](https://github.com/catppuccin/nix/issues/710) * [@SymphonySimper](https://github.com/SymphonySimper) made their first contribution in [#775](https://github.com/catppuccin/nix/issues/775) * [@aciceri](https://github.com/aciceri) made their first contribution in [#622](https://github.com/catppuccin/nix/issues/622) * [@alapshin](https://github.com/alapshin) made their first contribution in [#755](https://github.com/catppuccin/nix/issues/755) * [@aveeryy](https://github.com/aveeryy) made their first contribution in [#763](https://github.com/catppuccin/nix/issues/763) * [@musjj](https://github.com/musjj) made their first contribution in [#790](https://github.com/catppuccin/nix/issues/790) * [@nickthegroot](https://github.com/nickthegroot) made their first contribution in [#797](https://github.com/catppuccin/nix/issues/797) * [@signegrau](https://github.com/signegrau) made their first contribution in [#714](https://github.com/catppuccin/nix/issues/714) * [@tomperr](https://github.com/tomperr) made their first contribution in [#799](https://github.com/catppuccin/nix/issues/799)

# v25.05 - Better late than never! Long time no see! As you can probably tell by the date, it's not very close to May anymore. That's okay though, because our intention with this release is to introduce a new versioning strategy! > [!IMPORTANT] > TL;DR: **We will now be following Nixpkgs/NixOS/home-manager's unstable/stable release model.** > > This decision comes after some talks with @isabelroses and I, as well as seeing what issues we commonly come across. You can read a bit more about it [here](https://github.com/catppuccin/nix/pull/622#issuecomment-3122930961). ### What does this mean for me? If you currently follow our `main` branch and Nixpkgs unstable (this is hopefully most of you!), **you do not have to do anything**. If you currently follow our `main` branch and Nixpkgs stable (25.05), **you must switch to the `release-25.05` branch**. We will be giving everyone time to make this transition comfortably, by first only warning against usage of 25.05. If you currently follow our stable tags (i.e., v1.2.1), **you should update to our `main` or `release-25.05` branch depending on your Nixpkgs version**. # Changelog This release comes with **20 newly supported modules**, a complete overhaul to how we manage and install port contents, and a [nice new documentation site](https://nix.catppuccin.com)! We also want to give a special thanks to the nearly two dozen new contributors in this release cycle, as well as the countless returning contributors, and amazing members of the [Catppuccin Discord community](https://discord.com/servers/catppuccin-907385605422448742) ## 🚨 Breaking Changes - **modules**: drop support for nixpkgs 24.11 by [@getchoo](https://github.com/getchoo) - **home-manager/gtk**: remove by [@getchoo](https://github.com/getchoo) ## 🚀 Features - **fctix5**: add enableRounded option by [@isabelroses](https://github.com/isabelroses) - **home-manager**: init wlogout module by [@Anomalocaridid](https://github.com/Anomalocaridid) - **home-manager**: add support for chromium and chromium-based browsers by [@HeitorAugustoLN](https://github.com/HeitorAugustoLN) - **home-manager**: add support for ghostty by [@natecox](https://github.com/natecox) - **home-manager**: add support for lsd by [@mariovagomarzal](https://github.com/mariovagomarzal) - **home-manager**: add support for thunderbird by [@nim65s](https://github.com/nim65s) - **home-manager**: add support for nushell by [@isabelroses](https://github.com/isabelroses) - **home-manager**: add support for vscode by [@getchoo](https://github.com/getchoo) - **home-manager**: add support for wezterm by [@taranarmo](https://github.com/taranarmo) - **home-manager**: add support for swaync by [@Lichthagel](https://github.com/Lichthagel) - **home-manager**: add support for qutebrowser by [@fmway](https://github.com/fmway) - **home-manager**: add support for sioyak by [@n194](https://github.com/n194) - **home-manager**: add support for atuin by [@isabelroses](https://github.com/isabelroses) - **home-manager**: add support for firefox-based browsers by [@different-name](https://github.com/different-name) - **home-manager**: add support for xfce4-terminal by [@different-name](https://github.com/different-name) - **home-manager**: add support for element-desktop by [@SchweGELBin](https://github.com/SchweGELBin) - **home-manager**: add support for vesktop by [@SchweGELBin](https://github.com/SchweGELBin) - **home-manager**: add support for mangohud by [@SchweGELBin](https://github.com/SchweGELBin) - **home-manager/firefox**: enable 'default' profile by default by [@different-name](https://github.com/different-name) - **home-manager/firefox**: use options submodule to apply configuration by [@different-name](https://github.com/different-name) - **home-manager/hyprlock**: allow using default config for port by [@getchoo](https://github.com/getchoo) - **home-manager/neovim**: add option for custom settings by [@toodeluna](https://github.com/toodeluna) - **home-manager/vscode**: allow configuration of build by [@isabelroses](https://github.com/isabelroses) - **home-manager/vscode**: Add support for per-profile config by [@different-name](https://github.com/different-name) - **home-manager/vscode-icons**: init by [@isabelroses](https://github.com/isabelroses) - **home-manager/zed**: accent support by [@isabelroses](https://github.com/isabelroses) - **home-manager/zed-editor**: icon support by [@42willow](https://github.com/42willow) - **home-manager/zed-editor**: add ability to enable/disable icons by [@isabelroses](https://github.com/isabelroses) - **modules**: use package set for port sources by [@getchoo](https://github.com/getchoo) - **nixos**: add support for gitea/forgejo by [@Lichthagel](https://github.com/Lichthagel) - **nixos**: Add support for Limine by [@dinckelman](https://github.com/dinckelman) - global cachix option by [@isabelroses](https://github.com/isabelroses) ## 🐛 Bug Fixes - **catwalk**: enable useFetchCargoVendor by [@isabelroses](https://github.com/isabelroses) - **docs**: theming by [@isabelroses](https://github.com/isabelroses) - **gitea**: controlled by enable [#588](https://github.com/catppuccin/nix/issues/588) by [@luochen1990](https://github.com/luochen1990) - **home-manager/alacritty**: remove the `general` setting option by [@mariovagomarzal](https://github.com/mariovagomarzal) - **home-manager/fcitx5**: adjust source by [@isabelroses](https://github.com/isabelroses) - **home-manager/fcitx5**: support new enable option by [@brian14708](https://github.com/brian14708) - **home-manager/firefox**: set default profile safely by [@different-name](https://github.com/different-name) - **home-manager/firefox**: only apply to profiles specified by [@getchoo](https://github.com/getchoo) - **home-manager/gtk**: pass flavor and not variant by [@isabelroses](https://github.com/isabelroses) - **home-manager/gtk**: adjust config.gtk.name for new package by [@isabelroses](https://github.com/isabelroses) - **home-manager/mako**: use settings instead of extraConfig by [@MisileLab](https://github.com/MisileLab) - **home-manager/rofi**: update to use upstream overhaul by [@isabelroses](https://github.com/isabelroses) - **home-manager/zed**: correctly apply italics by [@getchoo](https://github.com/getchoo) - **home-manager/zed**: correctly enable & select accent by [@isabelroses](https://github.com/isabelroses) - **lib**: set defaultText for flavor and accent for mkCatppuccinOption by [@isabelroses](https://github.com/isabelroses) - **mako**: use theme directly by [@oliviafloof](https://github.com/oliviafloof) - **mako**: inherit from theme by [@oliviafloof](https://github.com/oliviafloof) - **mako**: deprecated settings.criteria by [@brian14708](https://github.com/brian14708) - **nixos/gitea**: copy files across for v12 forgejo by [@isabelroses](https://github.com/isabelroses) - **paws**: use hash instead of narHash by [@isabelroses](https://github.com/isabelroses) - **pkgs/nvim**: copy overrides from nixpkgs by [@w-lfchen](https://github.com/w-lfchen) - **pkgs/paws**: set timezone to UTC for fetcher by [@isabelroses](https://github.com/isabelroses) - **pkgs/rofi**: remove import at build by [@isabelroses](https://github.com/isabelroses) - **tests**: disable forgejo by [@isabelroses](https://github.com/isabelroses) - **whiskers**: enable useFetchCargoVendor by [@PerchunPak](https://github.com/PerchunPak) - **yazi**: update repository source by [@isabelroses](https://github.com/isabelroses) - use correct nixfmt package by [@getchoo](https://github.com/getchoo) - assert home-manager version for thunderbird module by [@nim65s](https://github.com/nim65s) - useFetchCargoVendor is non-optional and enabled by default as of 25.05 by [@Safenein](https://github.com/Safenein) ## ⏪ Reverted - "fix(home-manager/alacritty): remove the `general` setting option" by [@Yakkhini](https://github.com/Yakkhini) - "fix(home-manager/lazygit): avoid IFD" by [@getchoo](https://github.com/getchoo) ## 📚 Documentation - **FAQ**: move to catppuccin namespace by [@42willow](https://github.com/42willow) - **README**: sync FAQ with site by [@42willow](https://github.com/42willow) - **README**: link to IFD tracking issue by [@getchoo](https://github.com/getchoo) - show new option namespace by [@asymmetric](https://github.com/asymmetric) - update home-manager module name in readme by [@TheJolman](https://github.com/TheJolman) - move to starlight by [@getchoo](https://github.com/getchoo) - clean up and add release branch guides by [@getchoo](https://github.com/getchoo) ## New Contributors * [@HeitorAugustoLN](https://github.com/HeitorAugustoLN) made their first contribution in [#447](https://github.com/catppuccin/nix/issues/447) * [@MisileLab](https://github.com/MisileLab) made their first contribution in [#553](https://github.com/catppuccin/nix/issues/553) * [@Safenein](https://github.com/Safenein) made their first contribution in [#629](https://github.com/catppuccin/nix/issues/629) * [@TheJolman](https://github.com/TheJolman) made their first contribution in [#562](https://github.com/catppuccin/nix/issues/562) * [@Yakkhini](https://github.com/Yakkhini) made their first contribution in [#452](https://github.com/catppuccin/nix/issues/452) * [@asymmetric](https://github.com/asymmetric) made their first contribution in [#421](https://github.com/catppuccin/nix/issues/421) * [@awwpotato](https://github.com/awwpotato) made their first contribution in [#605](https://github.com/catppuccin/nix/issues/605) * [@brian14708](https://github.com/brian14708) made their first contribution in [#563](https://github.com/catppuccin/nix/issues/563) * [@different-name](https://github.com/different-name) made their first contribution in [#609](https://github.com/catppuccin/nix/issues/609) * [@dinckelman](https://github.com/dinckelman) made their first contribution in [#570](https://github.com/catppuccin/nix/issues/570) * [@fmway](https://github.com/fmway) made their first contribution in [#479](https://github.com/catppuccin/nix/issues/479) * [@frahz](https://github.com/frahz) made their first contribution in [#567](https://github.com/catppuccin/nix/issues/567) * [@gepbird](https://github.com/gepbird) made their first contribution in [#616](https://github.com/catppuccin/nix/issues/616) * [@karitham](https://github.com/karitham) made their first contribution in [#537](https://github.com/catppuccin/nix/issues/537) * [@khaneliman](https://github.com/khaneliman) made their first contribution in [#543](https://github.com/catppuccin/nix/issues/543) * [@kittywitch](https://github.com/kittywitch) made their first contribution in [#610](https://github.com/catppuccin/nix/issues/610) * [@luochen1990](https://github.com/luochen1990) made their first contribution in [#589](https://github.com/catppuccin/nix/issues/589) * [@mariovagomarzal](https://github.com/mariovagomarzal) made their first contribution in [#454](https://github.com/catppuccin/nix/issues/454) * [@n194](https://github.com/n194) made their first contribution in [#535](https://github.com/catppuccin/nix/issues/535) * [@natecox](https://github.com/natecox) made their first contribution in [#446](https://github.com/catppuccin/nix/issues/446) * [@nim65s](https://github.com/nim65s) made their first contribution in [#489](https://github.com/catppuccin/nix/issues/489) * [@taranarmo](https://github.com/taranarmo) made their first contribution in [#433](https://github.com/catppuccin/nix/issues/433) * [@toodeluna](https://github.com/toodeluna) made their first contribution in [#457](https://github.com/catppuccin/nix/issues/457)

### 🐛 Bug Fixes - **home-manager/zed**: use correct names by [@isabelroses](https://github.com/isabelroses)

This will (hopefully) be the final release before 2.0.0. In preparation for the next major release, our modules have been moved to a standard `catppuccin` namespace (i.e., `programs.bat.catppuccin.enable` is now `catppuccin.bat.enable`), but aliases to the old options remain for backwards compatibility. **These will be removed in 2.0.0** ### 🚀 Features - **home-manager**: add transparent option for micro by [@henrisota](https://github.com/henrisota) - **home-manager**: add support for zed-editor by [@isabelroses](https://github.com/isabelroses) - **modules**: move to catppuccin namespace by [@isabelroses](https://github.com/isabelroses) ### 📚 Documentation - fully document nix library by [@getchoo](https://github.com/getchoo)

### 🐛 Bug Fixes - fix eval on 25.05 by [@PerchunPak](https://github.com/PerchunPak) ### 📚 Documentation - **README**: fix typo `catppucin` -> `catppuccin` by [@42willow](https://github.com/42willow) - use nuscht search for options by [@getchoo](https://github.com/getchoo) - add nicer redirects by [@getchoo](https://github.com/getchoo) - use git-cliff for release changelogs by [@getchoo](https://github.com/getchoo)

## [1.1.0](https://github.com/catppuccin/nix/compare/v1.0.2...v1.1.0) (2024-11-08) ### Features * **home-manager/fcitx5:** add accent support ([#343](https://github.com/catppuccin/nix/issues/343)) ([0b7bf04](https://github.com/catppuccin/nix/commit/0b7bf04628414a402d255924f65e9a0d1a53d92b)) * **home-manager/fzf:** add accent support ([#331](https://github.com/catppuccin/nix/issues/331)) ([45745fe](https://github.com/catppuccin/nix/commit/45745fe5960acaefef2b60f3455bcac6a0ca6bc9)) * **home-manager/mako:** add accent color support ([#323](https://github.com/catppuccin/nix/issues/323)) ([966af28](https://github.com/catppuccin/nix/commit/966af28f2d5b7b5bd3f947d6bab5d7da3bf9fee4)) * **home-manager/mpv:** add support for uosc ([#291](https://github.com/catppuccin/nix/issues/291)) ([8bdb55c](https://github.com/catppuccin/nix/commit/8bdb55cc1c13f572b6e4307a3c0d64f1ae286a4f)) * **home-manager:** add support for aerc ([#338](https://github.com/catppuccin/nix/issues/338)) ([96cf8b4](https://github.com/catppuccin/nix/commit/96cf8b4a05fb23a53c027621b1147b5cf9e5439f)) * **home-manager:** add support for freetube ([#327](https://github.com/catppuccin/nix/issues/327)) ([6effc32](https://github.com/catppuccin/nix/commit/6effc32e614405c05a63a1365fd078a0ab996a0e)) * **home-manager:** add support for fuzzel ([#75](https://github.com/catppuccin/nix/issues/75)) ([7e23de3](https://github.com/catppuccin/nix/commit/7e23de352f519067ea88db869e9aa14222290a73)) * **home-manager:** add support for hyprlock ([#330](https://github.com/catppuccin/nix/issues/330)) ([faea883](https://github.com/catppuccin/nix/commit/faea8838116f5e5fa2ab4b00d97d8d1e0e382bae)) * **home-manager:** add support for obs-studio ([#324](https://github.com/catppuccin/nix/issues/324)) ([76dd2b2](https://github.com/catppuccin/nix/commit/76dd2b2e1f8d1ec7090c30462f8bcc0b7c598389)) * **home-manager:** add support for spotify-player ([#296](https://github.com/catppuccin/nix/issues/296)) ([ff4128f](https://github.com/catppuccin/nix/commit/ff4128f8ea57879050145cf077a27b9d3a9cbf33)) * **home-manager:** update yazi for accent support ([#360](https://github.com/catppuccin/nix/issues/360)) ([250c986](https://github.com/catppuccin/nix/commit/250c9865beae02ffaee4f49f7ab39137fc235cda)) * **nixos:** add support for fcitx5 ([#221](https://github.com/catppuccin/nix/issues/221)) ([309c49f](https://github.com/catppuccin/nix/commit/309c49f277e557002f271704803506c7e76432f4)) ### Bug Fixes * **home-manager/dunst:** avoid IFD ([#302](https://github.com/catppuccin/nix/issues/302)) ([9fdb8aa](https://github.com/catppuccin/nix/commit/9fdb8aaf65afaa4262ba41bfac1f45c3a7cc36a0)) * **home-manager/foot:** avoid IFD ([#300](https://github.com/catppuccin/nix/issues/300)) ([38df8bf](https://github.com/catppuccin/nix/commit/38df8bf46f0a88e11490de438100207a48040a9c)) * **home-manager/gtk:** support all tweaks ([#274](https://github.com/catppuccin/nix/issues/274)) ([5520567](https://github.com/catppuccin/nix/commit/552056779a136092eb6358c573d925630172fc30)) * **home-manager/hyprland:** allow merging `sources` option ([#309](https://github.com/catppuccin/nix/issues/309)) ([b1e6a8c](https://github.com/catppuccin/nix/commit/b1e6a8cbf12f86f0219a743a1f112ea20c0b2454)) * **home-manager/hyprland:** import accents from file ([#347](https://github.com/catppuccin/nix/issues/347)) ([65f2a8a](https://github.com/catppuccin/nix/commit/65f2a8a36422e54ae469f3fc6325775ce497724b)) * **home-manager/hyprland:** inherit cursor size, unset hyprcursor env vars ([#299](https://github.com/catppuccin/nix/issues/299)) ([512306a](https://github.com/catppuccin/nix/commit/512306ae5848d11a9b38afe4680b69e4908648a2)) * **home-manager/k9s:** support darwin without XDG ([#311](https://github.com/catppuccin/nix/issues/311)) ([0047cf5](https://github.com/catppuccin/nix/commit/0047cf5816313075f5a141daea73532525dbb5df)) * **home-manager/kitty:** use new `themeFile` option on 24.11 ([#337](https://github.com/catppuccin/nix/issues/337)) ([f91de98](https://github.com/catppuccin/nix/commit/f91de989e9671176ee4cda16c4b297d5a9682a45)) * **home-manager/kvantum:** don't uppercase accents and flavors in override ([#358](https://github.com/catppuccin/nix/issues/358)) ([641cfc3](https://github.com/catppuccin/nix/commit/641cfc36b644294c17f0bae4fac5a37e5bf53f4f)) * **home-manager/lazygit:** avoid IFD ([#304](https://github.com/catppuccin/nix/issues/304)) ([66f4ea1](https://github.com/catppuccin/nix/commit/66f4ea170093b62f319f41cebd2337a51b225c5a)) * **home-manager/lazygit:** support darwin without XDG ([#313](https://github.com/catppuccin/nix/issues/313)) ([8886a68](https://github.com/catppuccin/nix/commit/8886a68edadb1d93c7101337f995ffce4b410ff2)) * **home-manager/mpv:** avoid IFD ([#303](https://github.com/catppuccin/nix/issues/303)) ([f1ccaad](https://github.com/catppuccin/nix/commit/f1ccaad444ef97c84c59215e3858ed7a95fa7bff)) * **home-manager/tofi:** avoid IFD ([#301](https://github.com/catppuccin/nix/issues/301)) ([afe2c4c](https://github.com/catppuccin/nix/commit/afe2c4c8651c137c44ec45c5e01948979cb77bc7)) * **home-manager/zathura:** avoid IFD ([#298](https://github.com/catppuccin/nix/issues/298)) ([41d51d7](https://github.com/catppuccin/nix/commit/41d51d7f0459f95ab354b81ecbd49cc413a8d49d))

## [1.0.2](https://github.com/catppuccin/nix/compare/v1.0.1...v1.0.2) (2024-07-02) ### Bug Fixes * **home-manager/cursors:** exclude from `catppuccin.enable` ([#263](https://github.com/catppuccin/nix/issues/263)) ([9eb0610](https://github.com/catppuccin/nix/commit/9eb0610d48dd0e1fecf772bbdacf9050d7b82d7c)) ### Reverts * **gtk:** don't replace `normal` tweak with `default` ([#271](https://github.com/catppuccin/nix/issues/271)) ([7bfda77](https://github.com/catppuccin/nix/commit/7bfda77cd1c65a221edfc412051fab9c95102123))

## [1.0.1](https://github.com/catppuccin/nix/compare/v1.0.0...v1.0.1) (2024-06-30) ### Bug Fixes * **home-manager/gtk:** replace `normal` tweak with `default` ([#261](https://github.com/catppuccin/nix/issues/261)) ([92e2d7a](https://github.com/catppuccin/nix/commit/92e2d7ae880cd77677be66af2e77b2bc6b74f4fa))