https://github.com/quantum5/win2xcur

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

ani-cursor converts-cursors cur-files cursor cursor-theme windows x11 x11-cursor xcursor-format

Last synced: 6 days ago
JSON representation

win2xcur is a tool that converts cursors from Windows format (*.cur, *.ani) to Xcursor format. It also contains x2wincur which does the opposite.

• Host: GitHub
• URL: https://github.com/quantum5/win2xcur
• Owner: quantum5
• Created: 2020-09-26T22:15:36.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-07-01T17:38:25.000Z (7 months ago)
• Last Synced: 2025-01-13T00:10:16.357Z (13 days ago)
• Topics: ani-cursor, converts-cursors, cur-files, cursor, cursor-theme, windows, x11, x11-cursor, xcursor-format
• Language: Python
• Homepage:
• Size: 36.1 KB
• Stars: 189
• Watchers: 4
• Forks: 13
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• stars - quantum5/win2xcur

README

        
# `win2xcur` and `x2wincur` [![Build Status](https://img.shields.io/github/actions/workflow/status/quantum5/win2xcur/build.yml)](https://github.com/quantum5/win2xcur/actions) [![PyPI](https://img.shields.io/pypi/v/win2xcur.svg)](https://pypi.org/project/win2xcur/) [![PyPI - Format](https://img.shields.io/pypi/format/win2xcur.svg)](https://pypi.org/project/win2xcur/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/win2xcur.svg)](https://pypi.org/project/win2xcur/)

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

`x2wincur` is a tool that does the opposite: it converts cursors in the Xcursor

format to Windows format (`*.cur`, `*.ani`), allowing to use your favourite

Linux cursor themes on Windows.

## 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: `win2xcur`

For example, if you want to convert [the sample cursor](sample/crosshair.cur)

to Linux format:

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

## Usage: `x2wincur`

For example, if you want to convert DMZ-White to Windows:

    mkdir dmz-white/

    x2wincur /usr/share/icons/DMZ-White/cursors/* -o dmz-white/

## Troubleshooting

`win2xcur` and `x2wincur` should work out of the box on most systems. If you

are using unconventional distros (e.g. Alpine) and are getting errors related

to `wand`, please see the [Wand documentation on installation][wand-install].

  [wand-install]: https://docs.wand-py.org/en/0.6.7/guide/install.html