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

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

The conversion from X11 cursor to PNG I've used is a bit lossy. In reality the
cursors look better than in the pictures.

image:preview_gentoo.png[title=gentoo]
image:preview_gentoo-blue.png[title=gentoo-blue]
image:preview_gentoo-silver.png[title=gentoo-silver]

== Install

=== Gentoo

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

=== Other

Copy the contents of `cursors/` into `/usr/share/icons/` 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.

include::{uri-base}/raw/branch/main/CONTRIBUTING.adoc[]

include::{uri-base}/raw/branch/main/TODO.adoc[]