Skip to content
xscriptor-colorsPublic

About

Original X11 cursor themes in the Xscriptor palette: gradient X and monochrome Berlin, 78 cursors and full X11 aliases.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

Cursors

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.

Code license: MIT Artwork license: CC BY 4.0 Linux Hyprland X11 / Xcursor Cursors Entries Sizes


New here? Read the installation guide for a distribution-independent setup, or the manual for customization and troubleshooting.

Preview

Xscriptor-X

Xscriptor-X on a light background Xscriptor-X on a dark background

Xscriptor-Berlin

Xscriptor-Berlin on a light background Xscriptor-Berlin on a dark background

Packs

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.

Coverage

  • 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.h is present.
  • No broken symlinks, no clipped frames and no out-of-bounds hotspots (make validate checks this).

Palette

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

Install

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.

Quick install

git clone https://github.com/xscriptor-colors/cursors.git
cd cursors
make install

The themes are copied to ~/.local/share/icons/Xscriptor-X and ~/.local/share/icons/Xscriptor-Berlin.

Hyprland / Wayland

Apply immediately:

hyprctl setcursor Xscriptor-X 24
# or:
hyprctl setcursor Xscriptor-Berlin 24

Make 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")

GTK apps

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=24

Manual install

cp -r build/themes/Xscriptor-X ~/.local/share/icons/
cp -r build/themes/Xscriptor-Berlin ~/.local/share/icons/

Build

Requirements:

  • Python 3.10+
  • clickgen (provides ctgen)
  • Pillow
  • librsvg (provides rsvg-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.

Palette variants (cursors-cli)

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.

Repository layout

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

Scripts

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

CLI

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)

Design notes

  • 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 X marks 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.

License

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

Related repositories

About

Original X11 cursor themes in the Xscriptor palette: gradient X and monochrome Berlin, 78 cursors and full X11 aliases.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages