01. Overview & Architecture

Profile: v2.0.0
Purpose
Soothing pastel cursors in all Catppuccin flavors and accents.
Compatibility
Any distro (Server: BOTH)
Desktop Part
Cursor themes
Window Manager & Theme
Any WM / DE / Catppuccin
Full Description
Soothing pastel cursors in all Catppuccin flavors and accents.

02. Installation & Deployment

Method: Verified Command

Step-by-step deployment protocol

Step-by-step deployment
1Install catppuccin-cursors-mocha (AUR)
$yay -S catppuccin-cursors-mocha # AUR
$# Other distros: see the upstream README

03. Screenshot Gallery // Catppuccin Cursors

Capture 01 // Fullscreen
Catppuccin Cursors screenshot 1
01 / 08

04. Documentation & Guide

Source: catppuccin/cursorsRef: a7eb08527d
README.md|GitHub Flavored Markdown

Logo
Catppuccin for Cursors

Stargazers

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/v2.0.0/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) 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 build mocha # To build all variants under one single flavor.
    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

 

Copyright © 2021-present Catppuccin Org

GitHub Flavored Markdown (github-markdown-css)● Live Repo Synced