Original X11/Xcursor themes for Linux, drawn from scratch in the Xscriptor palette: rounded minimal silhouettes, a bright rim, a dark contour and a small X mark outside the body.
New here? Read the installation guide for a distribution-independent setup, or the manual for customization and troubleshooting.
| Pack | Look | Notes |
|---|---|---|
| Xscriptor-X | Full 16-colour palette gradient, gold rim, dark contour, X outside | Full-colour pack |
| Xscriptor-Berlin | Monochrome, white rim, dark contour, X outside | Works on light and dark desktops |
Both packs share the same geometry and hotspots. wait and left_ptr_watch
use a static hourglass badge in the minimal family.
- 179 entries per pack: 78 cursors + 101 standard aliases.
- 10 nominal sizes: 16, 20, 22, 24, 28, 32, 40, 48, 64 and 96 px.
- Every name shipped by modern system themes (Bibata, Adwaita, Breeze, KDE) is present.
- Every glyph in
X11/cursorfont.his present. - No broken symlinks, no clipped frames and no out-of-bounds hotspots
(
make validatechecks this).
| Token | Value |
|---|---|
| X minimal gradient | 16-color palette, #0a0a0a → … → #f7f1ff |
| X legacy gradient | #4328a8 → #7c3aed → #4d96ff → #ff9f43 → #f59e0b |
| X rim | #ffe884 |
| X contour | #171717 |
| Berlin gradient | #0a0a0a → #4b4b55 |
| Berlin rim | #ffffff |
| Berlin contour | #000000 |
For prebuilt and source installs, system-wide installation, and activation in Hyprland, GNOME, KDE, Xfce, X11, GTK, Qt, Electron and Flatpak, see the installation guide. For customization and troubleshooting, see the manual.
git clone https://github.com/xscriptor-colors/cursors.git
cd cursors
make installThe themes are copied to ~/.local/share/icons/Xscriptor-X and
~/.local/share/icons/Xscriptor-Berlin.
Apply immediately:
hyprctl setcursor Xscriptor-X 24
# or:
hyprctl setcursor Xscriptor-Berlin 24Make it permanent. In ~/.config/hypr/env.lua:
hl.env("XCURSOR_THEME", "Xscriptor-X")
hl.env("XCURSOR_SIZE", "24")Also update the cursor autostart (or gsettings will bring the old theme back
next login):
hl.exec_cmd("hyprctl setcursor Xscriptor-X 24")
hl.exec_cmd("gsettings set org.gnome.desktop.interface cursor-theme 'Xscriptor-X'")
hl.exec_cmd("gsettings set org.gnome.desktop.interface cursor-size 24")If a GTK app still uses another cursor, set it in both files:
# ~/.config/gtk-3.0/settings.ini
# ~/.config/gtk-4.0/settings.ini
gtk-cursor-theme-name=Xscriptor-X
gtk-cursor-theme-size=24cp -r build/themes/Xscriptor-X ~/.local/share/icons/
cp -r build/themes/Xscriptor-Berlin ~/.local/share/icons/Requirements:
- Python 3.10+
clickgen(providesctgen)- Pillow
librsvg(providesrsvg-convert)
pip install -r scripts/requirements.txt
make # generate + build + validate + preview
make install # build and copy both themes to ~/.local/share/icons
make validate # coverage, Xcursor format and hotspot checks
make preview # contact sheets and README previews in preview/
make clean # remove build/ and preview/The generated binaries are not committed. The SVG sources in src/ are the
single source of truth; build/themes is reproducible from them.
cli/ contains a self-contained CLI that builds a theme from a palette spec
without touching the curated src/ tree. It is the integration surface for
theme-sync or any other orchestrator. Variants use the X pack; Berlin is
monochrome and is installed once.
python3 cli/cursors-cli --spec cli/examples/cursor-spec.json --out-dir build/variants
# or:
make variant SPEC=cli/examples/cursor-spec.json OUT=build/variants SIZES="24 32 48"Spec:
{
"name": "Xscriptor-X-berlin",
"gradient": ["#0a0a0a", "#4d96ff", "#ff9f43", "#f59e0b", "#fce566"],
"rim": "#ffe884",
"contour": "#171717",
"sizes": [24, 32, 48]
}The five gradient colours map to the 0%, 28%, 52%, 76% and 100% stops.
name, rim, contour and sizes are optional. Intermediate SVG/PNG files
stay in a temporary directory; the final theme is published atomically to
--out-dir. The command prints one JSON object with theme, path, sizes,
design_version, spec_hash, cursors, entries and bytes.
Exit codes: 2 invalid spec, 3 missing tools, 4 build failure, 5 output
exists without --force.
cli/ palette-variant CLI (cursors-cli)
scripts/ artwork, catalogue, generators and validation
src/x/ Xscriptor-X SVG sources (generated, committed)
src/berlin/ Xscriptor-Berlin SVG sources (generated, committed)
docs/ INSTALL.md and MANUAL.md (installation, usage and troubleshooting)
build/ generated PNGs, manifests and Xcursor themes (ignored)
Makefile local pipeline
| File | Purpose |
|---|---|
scripts/art.py |
Original SVG artwork and palette definitions |
scripts/spec.py |
Cursor catalogue: hotspot, PNG pattern and X11 aliases |
scripts/generate.py |
Writes the SVG sources in src/ |
scripts/build.py |
SVG → PNG → clickgen manifest → ctgen |
scripts/preview.py |
Contact sheets and README previews |
scripts/validate.py |
Coverage, Xcursor format, hotspots and animation checks |
| Path | Purpose |
|---|---|
cli/cursors-cli |
Executable wrapper (--spec, --out-dir, --sizes, --dry-run) |
cli/cursors_cli/ |
Spec validation and variant build pipeline |
cli/examples/cursor-spec.json |
Example palette spec |
cli/tests/ |
Unit tests (make test-cli) |
- Every glyph is original; no Bibata assets or traced artwork are used.
- Cursor slot names are part of the X11/Xcursor conventions and are not claimed.
- The
Xmarks are decorative, long enough to read as an X at 24 px. - The dark contour keeps the cursor visible on light backgrounds; the gold/white rim keeps it visible on dark ones.
- Hotspots are defined once on the 256×256 canvas and scaled by
clickgen.
- Code (
scripts/,Makefile): MIT. See LICENSE. - Artwork (
src/and generated cursors): CC BY 4.0. Published previews live in the web repository. See LICENSE-ART. - Trademarks: see TRADEMARKS.md.
- xscriptor-colors — themes for terminals, editors and desktops.



