# `win2xcur` and `x2wincur` [](https://github.com/quantum5/win2xcur/actions) [](https://pypi.org/project/win2xcur/) [](https://pypi.org/project/win2xcur/) [](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
Raw data
{
"_id": null,
"home_page": "https://github.com/quantum5/win2xcur",
"name": "win2xcur",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "cur ani x11 windows win32 cursor xcursor",
"author": "quantum",
"author_email": "quantum2048@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/35/a6/ecd638a217480df7acb11dc1130c0e4df86e54560f529d29a1dff5fe8692/win2xcur-0.1.2.tar.gz",
"platform": null,
"description": "# `win2xcur` and `x2wincur` [](https://github.com/quantum5/win2xcur/actions) [](https://pypi.org/project/win2xcur/) [](https://pypi.org/project/win2xcur/) [](https://pypi.org/project/win2xcur/)\n\n`win2xcur` is a tool that converts cursors from Windows format (`*.cur`,\n`*.ani`) to Xcursor format. This allows Windows cursor themes to be used on\nLinux, for example.\n\n`win2xcur` is more than a simple image conversion tool. It preserves the cursor\nhotspot and animation delay, and has an optional mode to add shadows that\nreplicates Windows's cursor shadow effect.\n\n`x2wincur` is a tool that does the opposite: it converts cursors in the Xcursor\nformat to Windows format (`*.cur`, `*.ani`), allowing to use your favourite\nLinux cursor themes on Windows.\n\n## Installation\n\nTo install the latest stable version:\n\n pip install win2xcur\n\nTo install from GitHub:\n\n pip install -e git+https://github.com/quantum5/win2xcur.git\n\n## Usage: `win2xcur`\n\nFor example, if you want to convert [the sample cursor](sample/crosshair.cur)\nto Linux format:\n\n mkdir output/\n win2xcur sample/crosshair.cur -o output/\n\n`-s` can be specified to enable shadows.\nMultiple cursors files can be specified on the command line.\nFor example, to convert a directory of cursors with shadows enabled:\n\n win2xcur input/*.{ani,cur} -o output/ \n\nFor more information, run `win2xcur --help`.\n\n## Usage: `x2wincur`\n\nFor example, if you want to convert DMZ-White to Windows:\n\n mkdir dmz-white/\n x2wincur /usr/share/icons/DMZ-White/cursors/* -o dmz-white/\n\n## Troubleshooting\n\n`win2xcur` and `x2wincur` should work out of the box on most systems. If you\nare using unconventional distros (e.g. Alpine) and are getting errors related\nto `wand`, please see the [Wand documentation on installation][wand-install].\n\n [wand-install]: https://docs.wand-py.org/en/0.6.7/guide/install.html\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "win2xcur is a tool to convert Windows .cur and .ani cursors to Xcursor format.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/quantum5/win2xcur"
},
"split_keywords": [
"cur",
"ani",
"x11",
"windows",
"win32",
"cursor",
"xcursor"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ef609be23c6f203669aea140f0572d2e3a93eacb5ab43615af0d5f98ab33cda4",
"md5": "6e5a69389d8d04624a8c53ccaf966e4c",
"sha256": "bad701ab9c4031479091d81090b60efa85d08ff5a88f68e5410a9caa46a1c5ba"
},
"downloads": -1,
"filename": "win2xcur-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6e5a69389d8d04624a8c53ccaf966e4c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 13999,
"upload_time": "2023-05-23T02:39:31",
"upload_time_iso_8601": "2023-05-23T02:39:31.877364Z",
"url": "https://files.pythonhosted.org/packages/ef/60/9be23c6f203669aea140f0572d2e3a93eacb5ab43615af0d5f98ab33cda4/win2xcur-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "35a6ecd638a217480df7acb11dc1130c0e4df86e54560f529d29a1dff5fe8692",
"md5": "43e908d11f465afca690d0476af8aabd",
"sha256": "07cb2b3974015312ba759e868430397d8bf1501c4755cad23bfcfe516c85faa2"
},
"downloads": -1,
"filename": "win2xcur-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "43e908d11f465afca690d0476af8aabd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 10100,
"upload_time": "2023-05-23T02:39:33",
"upload_time_iso_8601": "2023-05-23T02:39:33.223473Z",
"url": "https://files.pythonhosted.org/packages/35/a6/ecd638a217480df7acb11dc1130c0e4df86e54560f529d29a1dff5fe8692/win2xcur-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-23 02:39:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "quantum5",
"github_project": "win2xcur",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": []
},
{
"name": "Wand",
"specs": []
}
],
"lcname": "win2xcur"
}
JSON
