hyprwm
/
hyprcursor
mirror of https://github.com/hyprwm/hyprcursor.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
hyprcursor/hyprcursor-util
History
SoSeDiK 178717746d
lib: Add validation for cursor file names and propagate the error from parsing HL cursor (#32) 
* Validate cursor file names

* Propagate errors from parsing HL cursor

* Validate cursor directory names
 		2024-04-12 01:01:33 +01:00
..
src lib: Add validation for cursor file names and propagate the error from parsing HL cursor (#32) 2024-04-12 01:01:33 +01:00
README.md util: update readme 2024-03-09 23:18:06 +00:00

README.md

hyprcursor-util

A utility to compile, pack, unpack, etc, hyprcursor and xcursor themes.

Runtime deps

  • xcur2png

States

Cursor themes can be in 3 states:

  • compiled hyprcursor - these can be used by apps / compositors.
  • compiled xcursor - these can be used by xcursor
  • working state - an easy to navigate mode where every cursor is a png / svg, and all the meta is in files.

Commands

--create | -c [path] -> create a compiled hyprcursor theme from a working state

--extract | -x [path] -> extract an xcursor theme into a working state

both commands support --output | -o to specify an output directory. For safety reasons, do not use this on versions below 0.1.1 as it will nuke the specified directory without asking.

Since v0.1.2, this directory is the parent, the theme will be written to a subdirectory in it called $ACTION_$NAME.

Flags

--resize [mode] - for extract: specify a default resize algorithm for shapes. Default is none.