quantum/win2xcur
1
0
Fork 0
mirror of https://github.com/quantum5/win2xcur.git synced 2025-04-24 02:01:57 -04:00
Code Issues Packages Projects Releases Wiki Activity
win2xcur is a tool that converts cursors from Windows format (*.cur, *.ani) to Xcursor format. It also contains x2wincur which does the opposite. https://github.com/quantum5/win2xcur
14 commits 5 branches 6 tags 113 KiB
Python 100%
Find a file
Quantum d887ea0ca6 Actually test animated cursors
2020-09-27 13:58:51 -04:00
.github/workflows Actually test animated cursors 2020-09-27 13:58:51 -04:00
sample Add example cursor created by hand 2020-09-26 18:26:27 -04:00
win2xcur More strict mypy checking 2020-09-27 13:58:51 -04:00
.flake8 Enforce import order 2020-09-27 01:02:12 -04:00
.gitignore Initial commit 2020-09-26 18:14:55 -04:00
mypy.ini More strict mypy checking 2020-09-27 13:58:51 -04:00
README.md Update README for release 2020-09-26 20:51:44 -04:00
requirements.txt Add GitHub actions for CI 2020-09-26 20:49:36 -04:00
setup.py Enforce import order 2020-09-27 01:02:12 -04:00

README.md

win2xcur Build Status PyPI PyPI - Format PyPI - Python Version

win2xcur is a tool that converts cursors from Windows format (*.cur, *.ani) to Xcursor format. This allows Windows cursor themes to be used on Linux, for example.

win2xcur is more than a simple image conversion tool. It preserves the cursor hotspot and animation delay, and has an optional mode to add shadows that replicates Windows's cursor shadow effect.

Installation

To install the latest stable version:

pip install win2xcur

To install from GitHub:

pip install -e git+https://github.com/quantum5/win2xcur.git

Usage

For example, if you want to convert the sample cursor:

mkdir output/
win2xcur sample/crosshair.cur -o output/

-s can be specified to enable shadows. Multiple cursors files can be specified on the command line. For example, to convert a directory of cursors with shadows enabled:

win2xcur input/*.{ani,cur} -o output/

For more information, run win2xcur --help.