About

This script maps Windows cursor names to Xcursor counterparts and creates a ready-to-use Xcursor file structure. Requires already converted Windows cursor files (by for example win2xcur).

Link to win2xcur GitHub page.

Definitions

<input_folder>    - folder with Windows cursor files (.ani and .cur)
<convert_folder>  - folder with files converted by win2xcur
<output_folder>   - folder with properly named Xcursor files

Step by step instruction

1. pip install win2xcur
   

   • used to do the initial conversion between Windows and Xcursor file formats
   • can (and probably should) be used with a venv

2. win2xcur <input_folder>/*.{ani,cur} -o <convert_folder>
   

   • the output folder must exist

   • if the original cursor does not have .ani files (or .cur, but that's very rare) you'll get an error, in which case use:

     <input_folder>/*.cur -o <convert_folder>

3. python ./cursor_map.py <convert_folder> <output_folder>
   

   • depending on your PATH entry use 'python' or 'python3'
   • the script will ask for cursor pack name, it must match the folder name

4. open <output_folder>/cursors/default in an image editor and export to thumbnail.png, save in the same folder

Destination folder

Once you have a folder with proper Xcursor files, move it to either:

• /usr/share/icons - makes cursor available for all users, requires root
• /home/<your_username>/.icons - makes it available only for you

Notes

• Right now the script creates copies instead of making symbolic links for icons that share the icon data but differ in name. Minor performance overhead for the system.
• Entries in mappings.txt were filled by hand through an eyeball search, mistakes may have been made. Feel free to tweak mappings.txt to your liking.

Project TODO

• fork win2xcur and integrate with project OR write own cursor conversion code (unlikely lol)
• integrate thumbnail.png creation into script
• replace creating copies with symlinks for better system performance