Skip to content

SystemRage/Metamorphosis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 and 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

License: GPL v3 © Matteo ℱan