A command-line tool for installing Windows animated cursor schemes on Unix-like operating systems running the X Window System.

Windows animated cursors use the ANI file format, a container format that stores multiple animation frames along with metadata such as frame timing and frame order.

Related cursors are grouped into cursor schemes. A cursor scheme is typically distributed together with an Install.inf file, which contains the metadata required to register and install the scheme.

ani2xcur utilizes this information to accurately convert each animated cursor into the Xcursor format and installs the resulting files in the locations expected by the X Window System.

While many larger projects now parse INF files to perform bulk cursor conversions, this project was the first to introduce that approach.

Originally created to fill that gap, it now focuses on providing an ergonomic solution: a single command-line interface with intentionally designed subcommands, optimized for speed and correctness.

Install from GitHub using cargo:

cargo install --git https://github.com/nicdgonzalez/ani2xcur

Or, download a pre-built binary from the Releases page on GitHub.

From the directory containing the Install.inf file, run:

ani2xcur install --default-init

From the directory containing the Install.inf file, run:

ani2xcur init

This command parses the INF file and extracts the information needed to decode each .ani file. The results are written to an intermediate Cursor.toml file.

Next, build the cursor theme:

ani2xcur build

This command parses each .ani file and generates animated cursors in Xcursor format. The cursors are placed in a theme directory using the standard X cursor naming conventions.

Then, install the theme:

ani2xcur install

This creates the necessary links so X can locate and use the newly created cursor theme.

Finally, enable the theme using your system's cursor settings. The exact process varies by distribution, but most desktop environments provide a command-line tool or a graphical settings panel.

Enjoy!

If you only want to convert a single ANI file:

mkdir custom-theme
mv *.ani ./custom-theme/
cd custom-theme

ani2xcur convert Default.ani

• Automatically scale cursors to standard sizes.
• Remove xcursorgen dependency.
• Remove need for build directory for the convert subcommand.
• Interactive mode to convert individual cursors with Linux remappings.