Say hello to your new cursor theme. Phinger Cursors is most likely the most over engineered cursor theme out there.
I'm maintaining phinger-cursors in the Arch User Repository. You can install it with your favorite AUR helper:
paru -S phinger-cursorsNote
Please let me know if you want to maintain this package in the official Arch Linux repositories, so that I can update the instructions here.
Install the phinnger-cursor-theme from the Ubuntu repositories (thanks to @eeickmeyer):
apt-get update
apt-get install phinger-cursor-themeYou can install the phinger-cursors package (thanks to @moni-dz) from the NixOS repositories by adding it to your configuration.nix:
environment.systemPackages = with pkgs; [
phinger-cursors
];Or use it in your home-manager configuration:
home.pointerCursor = {
name = "phinger-cursors-light";
package = pkgs.phinger-cursors;
size = 32;
gtk.enable = true;
};For a manual installation, download and extract the latest release into the ~/.local/share/icons directory.
mkdir -p ~/.local/share/icons
wget -cO- https://github.com/phisch/phinger-cursors/releases/latest/download/phinger-cursors-variants.tar.bz2 | tar xfj - -C ~/.local/share/iconsThis installs the cursor theme for your current user. To install for all users, extract into /usr/share/icons instead.
You might have a settings application installed that can do this for you like GNOME Tweaks, nwg-look or lxappearance. If you don't, enable the cursor theme as described below.
Enable your prefered variant phinger-cursors-dark, phinger-cursors-light or their left-handed counterparts phinger-cursors-dark-left or phinger-cursors-light-left inside ~/.icons/default/index.theme:
[Icon Theme]
Name=Default
Comment=Default Cursor Theme
Inherits=phinger-cursors-lightAnd finally, enable it for GTK applications in your ~/.config/gtk-3.0/settings.ini:
[Settings]
gtk-cursor-theme-name=phinger-cursors-lightThe available cursor sizes are 24, 32, 48, 64, 96 and 128. How to change it depends on your current environment.
Run the following command and replace CURSOR_SIZE with your prefered one:
- on GNOME:
gsettings set org.gnome.desktop.interface cursor-size CURSOR_SIZE - on MATE:
gsettings set org.mate.peripherals-mouse CURSOR_SIZE - on Xfce:
xfconf-query --channel xsettings --property /Gtk/CursorThemeSize --set CURSOR_SIZE
Add this line to your ~/.Xresources and replace CURSOR_SIZE with your prefered one:
Xcursor.size: CURSOR_SIZEPhinger Cursors are designed in a Figma document. Check out the multi-page Figma document used by this repository.
You can find an up to date copy of that document in this repositories root directory at phinger-cursors.fig.
Every cursor sprite is assembled from core parts. Changing one of those parts, will change every cursor sprite that uses it.
Each part is designed on a base grid of 24 and 32:
which means will be pixel perfect for any reasonable size:
| 24 | 32 | 48 | 64 | 72 | 96 | 128 |
|---|---|---|---|---|---|---|
 |
 |
 |
 |
 |
 |
 |
If possible, parts are designed very modular, which lets you create multiple different icons from one part. A good example is the hand part that comes with multiple variations for each single phinger:
The parts are assembled, and styled into sprites. Those sprites are named and contain metadata necessary to generate a cursor theme from them.
Each cursor contains information about which cursor and variant it belongs to, what its cursors aliases should be, how to transform it into a left-handed cursor, a hotspot element and instructions on how it should be animated.
Phinger Cursors are built using my Cursor Theme Builder. It provides a JSON schema to describe a cursor theme, an exporter, that can create such a JSON file and assets from a Figma file, and a builder, which makes fully functioning X11 cursor theme variants from that. It also allows to transform cursors into left-handed versions, comes with an animation system and more.
This repository contains workflows to extract a cursor-theme.json and assets, and drafts a release with built cursor theme variants.
All assets, including the Figma document are licensed under the CC-BY-SA-4.0 License.
Although designed from scratch, Phinger Cursors drew inspiration from capitaine-cursors, which is based on the KDE Breeze cursors. So this is a special thanks to them, and all other amazing cursor themes out there!
If you notice any issues like missing cursors or symlinks, something doesn't look quite right to you, or you have suggestions for better designs or new cursors, please open an issue and let me know about it.
I can't let people contribute to the Figma document directly, but I will listen to constructive feedback through GitHub issues.
I am actively working on Phinger Cursors and other cool projects on the Desktop Makers Discord. It aims to be a community for communities of Linux desktop related projects. If you are looking to collaborate with or want to contribute to great projects, this might be the right place for you.
