Free & Open source macOS Cursors.
GPL-3.0 License
Open source macOS Cursors for Windows
and Linux
with HiDPI Support .
build.toml
-> configs/win_lg.build.toml
, configs/win_rg.build.toml
, configs/win_xl.build.toml
, configs/x.build.toml
.bitmaps
directory removed, and macOS Monterey
cursors deprecated.16 20 22 24 28 32 40 48 56 64 72 80 88 96
size | Regular (× ²⁄₃) | Large (× ⁴⁄₅) | Extra-Large (× 1) |
---|---|---|---|
32 | 21.333 → 22 | 25.6 → 26 | 32 |
48 | 32 | 38.4 → 39 | 48 |
64 | 42.666 → 43 | 51.2 → 52 | 64 |
96 | 64 | 76.8 → 77 | 96 |
128 | 85.333 → 86 | 102.4 → 103 | 128 |
256 | 170.666 → 171 | 204.8 → 205 | 256 |
#000000
(Black)#FFFFFF
(White)#FFFFFF
(White)#000000
(Black)You can download latest stable
& development
releases from
Release Page.
Note If you're having trouble with the packages please submit a request to the package maintainer before creating an issue.
Arch Linux/Manjaro users can install from the AUR currently maintained by ful1e5 & Grelek . Can be installed via Pamac (preinstalled in Manjaro), Paru or any other AUR helper.
paru -S apple_cursor
openSUSE Tumbleweed users can install with 1 CLick Install
on openSUSE Software
or by adding the repository and installing the apple_cursor
package, maintained by astra
sudo zypper addrepo https://download.opensuse.org/repositories/home:/astra/openSUSE_Tumbleweed home:astra/Tumbleweed
sudo zyper install apple_cursor
Installation:
tar -xvf macOS.tar.gz # extract `.tar.gz`
mv macOS* ~/.icons/ # Install to local users
sudo mv macOS* /usr/share/icons/ # Install to all users
Uninstallation:
rm ~/.icons/macOS* # Remove from local users
sudo rm /usr/share/icons/macOS* # Remove from all users
Installation:
.zip
fileinstall.inf
.Uninstallation:
Run the uninstall.bat
script packed with the .zip
archive
OR follow these steps:
HKEY_CURRENT_USER
folder and expand Control Panel
folder.Cursors
folder and click on Schemes
folder - all the available custom cursors that areDelete
.git clone https://github.com/ful1e5/apple_cursor
cd apple_cursor
yarn install
yarn generate
Once you have the build prerequisites installed, You can personalize colors, customize sizes, change target platforms, and more. This process involves using external tools, as this repository only contains SVG files and configuration for these tools:
You can refer to the README of each tool for more information on their command-line options.
The process of creating custom cursor themes involves two main steps:
cbmp
provides three options for changing colors:
-bc
: Base color, which replaces the #00FF00
color in the SVG.-oc
: Outlined color, which replaces the #0000FF
color in the SVG.-wc
(optional): Watch Background color, which replaces the #FF0000
color in the SVG.npx cbmp [...] -bc '<hex>' -oc '<hex>' -wc '<hex>'
Alternatively, you can provide a JSON configuration file to render SVG files, which contains a sequence of cbmp
commands:
npx cbmp render.json
To build Windows cursor with size 16
:
ctgen build.toml -s 16 -p windows -d "bitmaps/macOS" -n "macOS" -c "macOS Cursors with size 16"
You can also customize output directory with -o
option:
ctgen build.toml -s 16 -p windows -d "bitmaps/macOS" -o "out" -n "macOS" -c "macOS Cursors with size 16"
To build XCursor with size 16
:
ctgen build.toml -s 16 -p x11 -d "bitmaps/macOS" -n "macOS" -c "macOS XCursors with size 16"
You can also assign multiple sizes to ctgen
for XCursors build:
ctgen build.toml -s 16 24 32 -p x11 -d "bitmaps/macOS" -n "macOS" -c "Custom Sizes macOS XCursors"
Lets generate macOS cursor with green and black colors:
npx cbmp -d "svg" -o "bitmaps/macOS-Hacker" -bc "#00FE00" -oc "#000000"
After rendering custom color you have to build cursor through ctgen
:
ctgen build.toml -d "bitmaps/macOS-Hacker" -n "macOS-Hacker" -c "Green and Black macOS cursors."
Afterwards, Generated theme can be found in the themes
directory.
npx cbmp -d "svg" -o "bitmaps/macOS-Gruvbox" -bc "#282828" -oc "#EBDBB2" -wc "#000000"
ctgen build.toml -d "bitmaps/macOS-Gruvbox" -n "macOS-Gruvbox" -c "Groovy macOS cursors."
npx cbmp -d "svg" -o "bitmaps/macOS-Solarized-Dark" -bc "#002b36" -oc "#839496" -wc "#000000"
ctgen build.toml -d "bitmaps/macOS-Solarized-Dark" -n "macOS-Solarized-Dark" -c "Solarized Dark macOS cursors."
npx cbmp -d "svg" -o "bitmaps/macOS-Solarized-Light" -bc "#839496" -oc "#002b36"
ctgen build.toml -d "bitmaps/macOS-Solarized-Light" -n "macOS-Solarized-Light" -c "Solarized Light macOS cursors."
npx cbmp -d "svg" -o "bitmaas/macOS-Dracula" -bc "#282a36" -oc "#f8f8f2"
ctgen build.toml -d "bitmaps/macOS-Dracula" -n "macOS-Dracula" -c "Dracula macOS cursors."
There are several websites that allow you to test your cursor states by hovering over buttons. This can be very useful when developing or verifying the behavior of a cursor. The following websites cover many of the most commonly used cursors, although they may not include all available options.
For a blueprint for creating XCursors, you may also want to refer to Cursor-demo.