Catppuccin for Cursors

Previews

🌻 Latte

🪴 Frappé

🌺 Macchiato

🌿 Mocha

Acknowledgement

This project is a modification of Volantes Cursors.

Installation

GitHub Release

1. Download your preferred flavor and accent from the latest GitHub release.

2. Extract the downloaded zip to one of the following locations:

   • For the local user: $HOME/.icons
   • For all users: /usr/share/icons

3. 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

1. Clone this repository and go to downloaded directory:

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

2. 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.

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

💝 Thanks to

• varlesh
• elkrien

 

Copyright © 2021-present Catppuccin Org