hyprcursor

History

Vaxry 4b9efbed7a util: wrap paths in quotes in shell invocations ref #10		2024-03-17 00:29:10 +00:00
..
src	util: wrap paths in quotes in shell invocations	2024-03-17 00:29:10 +00:00
CMakeLists.txt	cmake: add version define	2024-03-11 22:01:46 +00:00
README.md	util: update readme	2024-03-09 23:18:06 +00:00
internalSharedTypes.hpp	Initial commit: very basics	2024-03-07 03:19:38 +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.