catppuccin/cursors - Githubissues

Catppuccin for Cursors

Previews

🌻 Latte

🪴 Frappé

🌺 Macchiato

🌿 Mocha

Acknowledgement

This project is a modification of Volantes Cursors.

Installation

GitHub Release

Download your preferred flavor and accent from the latest GitHub release.
Extract the downloaded zip to one of the following locations:
- For the local user: $HOME/.icons
- For all users: /usr/share/icons
Choose the theme in your settings.

Example Installation

cd $HOME/.icons # or `/usr/share/icons`
curl -LOsS https://github.com/catppuccin/cursors/releases/download/v1.0.1/catppuccin-frappe-blue-cursors.zip
unzip catppuccin-frappe-blue-cursors.zip

Arch Linux

Individual flavor packages are available to download with your preferred AUR helper:

yay -S catppuccin-cursors-latte
yay -S catppuccin-cursors-frappe
yay -S catppuccin-cursors-macchiato
yay -S catppuccin-cursors-mocha

A -git package is also available which builds the cursors from source. This package contains all variants of flavor and accent.

yay -S catppuccin-cursors-git

NixOS

Nixpkgs has catppuccin-cursors. Use it by providing your preferred flavor + accent in camelCase. E.g.

pkgs.catppuccin-cursors.mochaMauve

Manual Installation

Requirements

python3 to execute scripts in the codebase.
whiskers to generate the cursor SVGs.
xcursorgen to generate the cursors.
inkscape to convert SVGs to PNGs.
(Optional) hyprcursor to include hyprcursor variants.
(Optional) just to easily run development commands.

Steps

Clone this repository and go to downloaded directory:

git clone https://github.com/catppuccin/cursors.git
cd cursors

Run the following command(s) if you have just installed, if not then look inside the justfile to understand what commands are being run.

just all # Build all flavor-accent variants.
just all_with_hyprcursor # Build all flavor-accent variants with hyprcursor support
just build mocha # To build all variants under one single flavor.
just build_with_hyprcursor mocha # To build all variants under one single flavor with hyprcursor support
just build mocha blue # To build only the blue variant under mocha.
just build mocha 'blue mauve peach' # To build only the blue, mauve, and peach variants under mocha.

Extract built cursors in ./dist to $HOME/.icons or /usr/share/icons.