Skippyr's Cursor

Starting Point

A 58x58 pixels custom cursor for X11 (aka Linux) with my GitHub avatar.

Here is a quick preview.

Installation And Usage

Installing From Releases (recommended)

By installing it this way, you do not have to build it. Follow these steps:

• Download the skippyr_cursor.zip file from the latest release.
• Unzip the file.
• Copy the skippyr_cursor directory extracted to ~/.local/share/icons. You might need to create that directory first.

After extracting, ensure that you are copying the directory containing the cursor files, as some system utilities that extract ZIP files might create an extra directory around the contents, which may cause the system to not recognize the cursor.

Building From Source

Follow these steps:

• Install the build dependencies:
• imagemagick (latest version)

The latest version is required to build the PNG images from the source files.

• xcursorgen

The X11 utility to create a cursor from PNG files.

• ruby

The programming language used in the build script.

• git

The utility to clone this repository.

• Clone this repository.

git clone --depth=1 https://github.com/skippyr/skippyr_cursor

• Access the repository's directory.

cd skippyr_cursor

• Run the build script.

ruby scripts/build.rb

This script will create the cursor and also the images and place them under the distributions directory:

• Install the cursor for your current user by copying it to ~/.local/share/icons.

mkdir -p ~/.local/share/icons
cp -r distributions/skippyr_cursor ~/.local/share/icons
					

Issues And Suggestions

Report issues and suggestions through the issues tab.

License

This project is released under terms of the MIT License.

Copyright (c) 2023, Sherman Rofeman. MIT License.