NekoCurX

Convert Windows cursor themes (.ani / .cur) into Linux XCursor themes.

NekoCurX is a command-line utility designed to simplify cursor theme migration between Windows and Linux. It automatically detects cursor roles, converts supported formats, generates Linux-compatible themes, and preserves compatibility aliases used across modern desktop environments.

Features • Installation • Usage • Output

---

Features

• ANI (.ani) cursor conversion
• CUR (.cur) cursor conversion
• Automatic cursor role detection
• install.inf mapping support
• Linux XCursor theme generation
• Compatibility alias generation
• Theme metadata generation
• One-command installation
• Batch theme conversion
• High-DPI Windows cursor support
• Linux-friendly cursor normalization (--linux-friendly)
• Automatic multi-size cursor generation (32, 48, 64, 128)
• Hotspot scaling and preservation

---

Installation

Download Release

Download the latest release and extract it:

tar -xf NekoCurX-v0.1.1-linux-x86_64.tar.gz
cd NekoCurX-v0.1.1

Run:

./nkx --help

Build From Source

git clone https://github.com/AikoAii/NekoCurX.git

cd NekoCurX

cmake -B build
cmake --build build

Run:

./build/src/nkx --help

---

Usage

Scan a theme:

nkx scan ThemeFolder/

Inspect a cursor:

nkx inspect Busy.ani

Convert a theme:

nkx convert ThemeFolder/

Convert with custom metadata:

nkx convert ThemeFolder/ \
  --theme "My Cursor Theme" \
  --comment "Custom Linux cursor theme" \
  --author "Aiko"

Install directly:

nkx install ThemeFolder/

Convert a High-DPI Windows theme:

nkx convert ThemeFolder/ --linux-friendly

Install a High-DPI theme directly:

nkx install ThemeFolder/ --linux-friendly

---

Output

ThemeName-Linux/

├── cursors/
├── extras/
├── metadata.json
└── index.theme

Generated themes can be installed manually or directly through the install command.

---

Support

If you find this project useful and would like to support its development:

---

License

MIT License. See LICENSE for details.