https://github.com/systemrage/metamorphosis
The Ultimate Cursor Converter
https://github.com/systemrage/metamorphosis
ani ani-cursor conversion converter cur cursor cursor-ani cursor-conversion cursor-converter cursor-fx cursor-theme cursor-x11 cursor-xp cursors decoder encoder python reader writer x11-cursor
Last synced: 21 days ago
JSON representation
The Ultimate Cursor Converter
- Host: GitHub
- URL: https://github.com/systemrage/metamorphosis
- Owner: SystemRage
- License: gpl-3.0
- Created: 2018-03-18T22:52:22.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-02-03T19:06:32.000Z (over 1 year ago)
- Last Synced: 2025-03-30T20:11:23.695Z (about 2 months ago)
- Topics: ani, ani-cursor, conversion, converter, cur, cursor, cursor-ani, cursor-conversion, cursor-converter, cursor-fx, cursor-theme, cursor-x11, cursor-xp, cursors, decoder, encoder, python, reader, writer, x11-cursor
- Language: Python
- Homepage:
- Size: 121 KB
- Stars: 46
- Watchers: 2
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Metamorphosis
> *The Ultimate Cursor Converter*
## Why
After several researches, i come to the conclusion that it doesn't exist a robust tool performing cursors conversions
between the different platform formats.
So inspired by [cfx2xc.py](https://github.com/coolwanglu/cfx2xc/blob/master/cfx2xc.py) and [sd2xc.pl](https://github.com/ludios/sd2xc/blob/master/sd2xc.pl), i decided to create one very cool.
## Requirements
- `Python 3+`,
- `PIL (Pillow)`
- `xcursorgen`
- `tar`
- `[Iconolatry](https://github.com/SystemRage/Iconolatry)`
## Features
* Extraction of `CursorFX` / `CursorXP` theme images and:
* Conversion to Linux `X11` or Windows `.ani` cursors.
* Automatic correction for lazy authors' mistakes.
* Supports default animations or script animations (also with *repeat* / *end repeat* loops).
* Supports clicked cursors ( only extraction ).
* Conversion of `.cur` or `.ani` to `X11` cursors.
* Conversion of `X11` to `.ani` cursors.
* Generic:
* Detailed log file creation.
* Packaging of converted cursors.
* Allows cursors resizing.
* Changes cursors color.
* Generates installations files for destination platform.
## Usage
`python3 Metamorphosis.py -h` for all available options.
Conversion to `X11` of an unpaired file and a files folder, packing results as `.tar.gz`:
`python3 Metamorphosis.py -i /path/to/folder/with/some/cursors -i /path/to/a/specific/cursor/file/Example3.CursorFX -o /path/converted/cursors -t Linux -p`
where an example of the directory and file structure is:
```
/path/to/folder/with/some/cursors
│ Example1.CursorFX
│ Example2.CurXPTheme
│
└───folder_with_cur_and_ani_1
| │ Help.cur
| │ Crosshair.cur
| | Arrow.ani
| | Button.ani
|
└───folder_with_cur_and_ani_2
| SizeNS.cur
| SizeS.ani
| SizeWE.ani
```
Conversion to `.ani` of a files folder, outputting to working directory, resizing and changing original color:
`python3 Metamorphosis.py -i /path/to/folder/with/some/cursors -t Windows -s 32 -c gbr`
where an example of the directory and file structure is:
```
/path/to/folder/with/some/cursors
│ Example1.CursorFX
│ Example2.CurXPTheme
│
└───folder_with_X11
│ top-left-arrow
│ progress
| crosshair
| pencil
```
## Notes
- Remember that `.cur`, `.ani` or `X11` must have standard names.
- Do **NOT** distribute the converted themes without the permission of the original author.
## License
[](https://www.gnu.org/licenses/gpl-3.0) © Matteo ℱan