{"id":13822106,"url":"https://github.com/phisch/phinger-cursors","last_synced_at":"2025-05-16T15:32:46.709Z","repository":{"id":39252850,"uuid":"438536966","full_name":"phisch/phinger-cursors","owner":"phisch","description":"Most likely the most over engineered cursor theme.","archived":false,"fork":false,"pushed_at":"2024-07-15T10:35:31.000Z","size":5473,"stargazers_count":565,"open_issues_count":2,"forks_count":15,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-05T08:10:06.125Z","etag":null,"topics":["cursor-theme","cursors","linux","ricing","theme","wayland","x11"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phisch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["phisch"]}},"created_at":"2021-12-15T07:34:38.000Z","updated_at":"2024-08-01T18:14:11.000Z","dependencies_parsed_at":"2024-04-06T21:21:15.905Z","dependency_job_id":"a81c5fdf-9495-41ed-992e-911a6ff8386a","html_url":"https://github.com/phisch/phinger-cursors","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phisch%2Fphinger-cursors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phisch%2Fphinger-cursors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phisch%2Fphinger-cursors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phisch%2Fphinger-cursors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phisch","download_url":"https://codeload.github.com/phisch/phinger-cursors/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225436520,"owners_count":17474159,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cursor-theme","cursors","linux","ricing","theme","wayland","x11"],"created_at":"2024-08-04T08:01:43.066Z","updated_at":"2024-11-19T22:32:18.131Z","avatar_url":"https://github.com/phisch.png","language":null,"funding_links":["https://github.com/sponsors/phisch"],"categories":["Others"],"sub_categories":[],"readme":"# Phinger Cursors\n\nSay hello to your new cursor theme. Phinger Cursors is most likely the most over engineered cursor theme out there.\n\n![preview](assets/preview.png)\n\n## How to install\n\n### Arch Linux\n\nI'm maintaining [phinger-cursors](https://aur.archlinux.org/packages/phinger-cursors) in the Arch User Repository. You can install it with your favorite AUR helper:\n\n```sh\nparu -S phinger-cursors\n```\n\n\u003e [!NOTE]\n\u003e 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.\n\n### Ubuntu\n\nInstall the `phinnger-cursor-theme` from the Ubuntu repositories (thanks to @eeickmeyer):\n\n```sh\napt-get update\napt-get install phinger-cursor-theme\n```\n\n### NixOS\n\nYou can install the `phinger-cursors` package (thanks to @moni-dz) from the NixOS repositories by adding it to your `configuration.nix`:\n\n```nix\nenvironment.systemPackages = with pkgs; [\n  phinger-cursors\n];\n```\n\nOr use it in your home-manager configuration:\n\n```nix\nhome.pointerCursor = {\n  name = \"phinger-cursors-light\";\n  package = pkgs.phinger-cursors;\n  size = 32;\n  gtk.enable = true;\n};\n```\n\n### Manually\n\nFor a manual installation, download and extract the [latest release](https://github.com/phisch/phinger-cursors/releases/latest/download/phinger-cursors-variants.tar.bz2) into the `~/.local/share/icons` directory.\n\n```sh\nmkdir -p ~/.local/share/icons\nwget -cO- https://github.com/phisch/phinger-cursors/releases/latest/download/phinger-cursors-variants.tar.bz2 | tar xfj - -C ~/.local/share/icons\n```\n\nThis installs the cursor theme for your current user. To install for all users, extract into `/usr/share/icons` instead.\n\n## How to enable\n\nYou might have a settings application installed that can do this for you like [GNOME Tweaks](https://gitlab.gnome.org/GNOME/gnome-tweaks), [nwg-look](https://github.com/nwg-piotr/nwg-look) or [lxappearance](https://wiki.lxde.org/en/LXAppearance). If you don't, enable the cursor theme as described below.\n\n### Manually\n\nEnable 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`:\n\n```ini\n[Icon Theme]\nName=Default\nComment=Default Cursor Theme\nInherits=phinger-cursors-light\n```\n\nAnd finally, enable it for GTK applications in your `~/.config/gtk-3.0/settings.ini`:\n\n```ini\n[Settings]\ngtk-cursor-theme-name=phinger-cursors-light\n```\n\n## How to change cursor size\n\nThe available cursor sizes are `24`, `32`, `48`, `64`, `96` and `128`. How to change it depends on your current environment.\n\n### GNOME, MATE, Xfce\n\nRun the following command and replace `CURSOR_SIZE` with your prefered one:\n\n- on GNOME: `gsettings set org.gnome.desktop.interface cursor-size CURSOR_SIZE`\n- on MATE: `gsettings set org.mate.peripherals-mouse CURSOR_SIZE`\n- on Xfce: `xfconf-query --channel xsettings --property /Gtk/CursorThemeSize --set CURSOR_SIZE`\n\n### Xresources\n\nAdd this line to your `~/.Xresources` and replace `CURSOR_SIZE` with your prefered one:\n\n```sh\nXcursor.size: CURSOR_SIZE\n```\n\n## How it's made\n\nPhinger Cursors are designed in a [Figma](https://www.figma.com) document. Check out the [multi-page Figma document](https://www.figma.com/file/zU99op23bu3Cg438YkhZy8/phinger-cursors) used by this repository.\n\nYou can find an up to date copy of that document in this repositories root directory at [phinger-cursors.fig](phinger-cursors.fig).\n\n### Parts\n\nEvery cursor sprite is assembled from core parts. Changing one of those parts, will change every cursor sprite that uses it.\n\n![parts](assets/parts.png)\n\nEach part is designed on a base grid of 24 and 32:\n\n![parts](assets/grid\u0026#32;sizes.png)\n\nwhich means will be pixel perfect for any reasonable size:\n\n|             24              |             32              |             48              |             64              |             72              |             96              |              128              |\n| :-------------------------: | :-------------------------: | :-------------------------: | :-------------------------: | :-------------------------: | :-------------------------: | :---------------------------: |\n| ![24](assets/sprite_24.png) | ![32](assets/sprite_32.png) | ![48](assets/sprite_48.png) | ![64](assets/sprite_64.png) | ![72](assets/sprite_72.png) | ![96](assets/sprite_96.png) | ![128](assets/sprite_128.png) |\n\nIf 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:\n\n![phingers](assets/phingers.png)\n\n### Sprites\n\nThe parts are assembled, and styled into sprites. Those sprites are named and contain metadata necessary to generate a cursor theme from them.\n\nEach 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.\n\n### Build process\n\nPhinger Cursors are built using my [Cursor Theme Builder](https://github.com/phisch/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.\n\nThis repository contains [workflows](.github/workflows) to extract a cursor-theme.json and assets, and drafts a release with built cursor theme variants.\n\n## License \u0026 Credits\nAll assets, including the Figma document are licensed under the [CC-BY-SA-4.0 License](LICENSE).\n\nAlthough designed from scratch, Phinger Cursors drew inspiration from [capitaine-cursors](https://github.com/keeferrourke/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!\n\n## Contribute\n\nIf 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.\n\nI can't let people contribute to the Figma document directly, but I will listen to constructive feedback through GitHub issues.\n\n### Desktop Makers\n\n\u003ca href=\"https://discord.gg/RqKTeA4uxW\" title=\"Desktop Makers Discord\"\u003e\u003cimg align=\"left\" width=\"72\" alt=\"type=discord\" src=\"https://user-images.githubusercontent.com/1282767/161089772-d7ad28bf-76eb-4951-b0f0-985afd5ea57a.png\"\u003e\u003c/a\u003e\n\nI am actively working on Phinger Cursors and other cool projects on the [Desktop Makers Discord](https://discord.gg/RqKTeA4uxW). 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphisch%2Fphinger-cursors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphisch%2Fphinger-cursors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphisch%2Fphinger-cursors/lists"}