.\" Automatically generated by Pandoc 3.1.11.1
.\"
.TH "hyprcursor\-util" "1" "" "" "hyprcursor-util User Manual"
.SH NAME
hyprcursor\-util \- A utility to compile, pack, unpack, etc.
hyprcursor and xcursor themes
.SH SYNOPSIS
\f[B]hyprcursor\-util\f[R] \-c <path> [\-o <dir>]
.PP
\f[B]hyprcursor\-util\f[R] \-x <path> [\-o <dir>] [\-\-resize [mode]]
.SH OPTIONS
.TP
\f[B]\-c <path>, \-\-create <path>\f[R]
Create a compiled hyprcursor theme from a working state
.TP
\f[B]\-x <path>, \-\-extract <path>\f[R]
Extract an xcursor theme into a working state.
This option uses the external program \f[B]xcur2png(1)\f[R] for
converting xcursor theme files to a format required by hyprcursor.
.TP
\f[B]\-o <path\-to\-dir>, \-\-output <path\-to\-dir>\f[R]
Both \f[B]\-\-create\f[R] and \f[B]\-\-extract\f[R] supports the
\f[B]\-output\f[R] option to specify an output directory.
For safety reasons, \f[B]do not use this on versions below 0.1.1\f[R] as
it will nuke the specified directory without asking.
.RS
.PP
Since v0.1.2, this directory is the parent, the theme will be written to
a subdirectory in it called \f[B]ACTION_NAME\f[R].
.RE
.TP
\f[B]\-\-resize [mode]\f[R]
For use with \f[B]\-\-extract\f[R] option.
Specify a default resize algorithm for shapes.
Default is \f[B]none\f[R].
.TP
\f[B]\-v, \-\-version\f[R]
Print info about the version of hyprcursor\-util.
.SH DESCRIPTION
.TP
Cursor themes can be in 3 states:
.IP \[bu] 2
\f[B]compiled hyprcursor\f[R] \- these can be used by apps / compositors
.IP \[bu] 2
\f[B]compiled xcursor\f[R] \- these can be used by xcursor
.IP \[bu] 2
\f[B]working state\f[R] \- an easy to navigate mode where every cursor
is a png/svg, and all the meta is in files
.SH AUTHORS
This man page is written for the Debian GNU/Linux system by Alan M
Varghese.
The information in this page is collected from the official README file
included with hyprcursor\-util source files.