= gentoo-xcursors
:toc: preamble
:project: gentoo-xcursors
:uri-base: https://schlomp.space/tastytea/{project}
:uri-branch-main: {uri-base}/src/branch/main

A high quality set of animated mouse cursors.

The original authors are unknownfootnote:[If you are one of the authors, please
get in touch so that you can be properly attributed.], the source of the initial
commit is the file `gentoo-cursors-tad-0.3.1.tar.bz2` from the Gentoo
mirrors. If you have the source files used to generate the cursors, please get
in touch.

== Previews

image:preview_gentoo.png[]
image:preview_gentoo-blue.png[]
image:preview_gentoo-silver.png[]

== Install

=== Gentoo

[source,shell]
--------------------------------------------------------------------------------
emerge -a x11-themes/gentoo-xcursors
--------------------------------------------------------------------------------

=== Other

Copy the contents of `cursors/` into `/usr/share/cursors/xorg-x11/cursors/` or
`~/.icons/`.

== Configuration

See https://wiki.gentoo.org/wiki/Cursor_themes[Gentoo Wiki: Cursor themes]. The
available sizes are 16, 24, 32, 48 and 64.

== License

gentoo-xcursors is licensed under the MIT license. See
link:{uri-branch-main}/LICENSE[LICENSE] for details.