breeze-hacked-cursor-theme

August 12, 2026 · View on GitHub

Official cursor theme for Jam OS

Please ★ this repo if you found it useful ★ ★ ★

Features

Installation

# system-wide (installs to /usr/local/share/icons)
sudo make install

# current user only (installs to ~/.local/share/icons)
make install PREFIX=~/.local

install honors PREFIX and DESTDIR, so packagers can stage the theme with make install DESTDIR=/tmp/pkgroot PREFIX=/usr. make uninstall removes it again.

Building

Building renders src/cursors.svg with Inkscape and assembles the cursors with xcursorgen, so both must be installed:

make

On hosts without the render tools (e.g. macOS, where xcursorgen is not available), build inside a container instead:

make build/docker

Recoloring

Before building and installing, run the following:

# Replace values with hex codes of desired colors
./recolor-cursor.sh --accent-color "#012345" --base-color "#6789ab" --border-color "#cdef10" --logo-color "#111213"

For more information, run the following:

./recolor-cursor.sh --help

Development

make prepare  # install the pinned dev toolchain (shfmt, bats) via asdf
make test     # run the bats test suite against the built theme
make format   # format shell scripts
make lint     # check shell script formatting

Support

Submit an issue

Screenshots

breeze-hacked-cursor-theme

Contributing

Review the guidelines for contributing

License

GPL 2.0 License

Changelog

Review the changelog

Credits