ful1e5 / apple_cursor

Free & Open source macOS Cursors.

Apple Cursor

Open source macOS Cursors for Windows and Linux with HiDPI Support .

Notes

• All cursor's SVG files are found in svg directory or you can also find them on Figma.

• 2024-04-26: c684a72e967b58d85492fae5fa68040beae47c10 Partitioned cursor build configuration into multiple files according to platform: build.toml -> configs/win_lg.build.toml, configs/win_rg.build.toml, configs/win_xl.build.toml, configs/x.build.toml.
• 2024-02-23: 07767c24b0c5dbf912cf37350b86adc11671a18e bitmaps directory removed, and macOS Monterey cursors deprecated.

---

Cursor Sizes

Xcursor Sizes:

16 20 22 24 28 32 40 48 56 64 72 80 88 96

Windows Cursor Size:

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

Colors

Default

• Base Color - #000000 (Black)
• Outline Color - #FFFFFF (White)

White

• Base Color - #FFFFFF (White)
• Outline Color - #000000 (Black)

How to get it

You can download latest stable & development releases from Release Page.

Packages

Note If you're having trouble with the packages please submit a request to the package maintainer before creating an issue.

Arch Linux/Manjaro

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

Installing Apple Cursor

Linux/X11

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

Windows

Installation:

1. Unzip .zip file
2. Open unziped directory in Explorer, and right click on install.inf.
3. Click 'Install' from the context menu, and authorize the modifications to your system.
4. Open Control Panel > Personalization and Appearance > Change mouse pointers, and select macOS Cursors.
5. Click 'Apply'.

Uninstallation:

Run the uninstall.bat script packed with the .zip archive

OR follow these steps:

1. Go to Registry Editor by typing the same in the start search box.
2. Expand HKEY_CURRENT_USER folder and expand Control Panel folder.
3. Go to Cursors folder and click on Schemes folder - all the available custom cursors that are installed will be listed here.
4. Right Click on the name of cursor file you want to uninstall; for eg.: macOS Cursors and click Delete.
5. Click 'yes' when prompted.

Build From Source

Prerequisites

• Python version 3.7 or higher
• clickgen>=2.2.2 (pip install clickgen)
• yarn

Quick start

1. Install build prerequisites on your system
2. git clone https://github.com/ful1e5/apple_cursor
3. cd apple_cursor
4. yarn install
5. yarn generate
6. See Installing Apple Cursor.

Getting Started

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:

• cbmp: Used for customizing colors and generating PNG files.
• ctgen: Used for customizing sizes and building XCursor and Windows Cursors.

You can refer to the README of each tool for more information on their command-line options.

Crafting Your Apple Cursor

The process of creating custom cursor themes involves two main steps:

1. Rendering SVG files to PNG files.
2. Building cursor themes from PNG files.

Customize Colors

cbmp provides three options for changing colors:

1. -bc: Base color, which replaces the #00FF00 color in the SVG.
2. -oc: Outlined color, which replaces the #0000FF color in the SVG.
3. -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

Customize Sizes

Customize Windows Cursor size

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"

Customize XCursor size

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"

Examples

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.

macOS Gruvbox

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."

macOS Solarized Dark

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."

macOS Solarized Light

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."

macOS Dracula

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."

Testing Cursor

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.

• Cursor-Test
• Mozilla CSS Cursor

For a blueprint for creating XCursors, you may also want to refer to Cursor-demo.

Credit

Adwaita · Dmz · Yaru

apple_cursor's Issues

Yarn problem

Description of the problem

umm... this is kinda weird, i don't know why, but when i try to run "make" command, it's have an error:
make[1]: Entering directory '/home/kali/apple_cursor/bitmapper'
make[1]: yarn: No such file or directory
make[1]: *** [Makefile:13: install] Error 127
make[1]: Leaving directory '/home/kali/apple_cursor/bitmapper'
make: *** [Makefile:10: render] Error 2

How has this issue affected you? What are you trying to accomplish?

i want to custom my cursor size, with command: make unix, and this problem is not allow me to do that

Logs or Screenshots: (optional)

Your Environment

My system information:

| Software | Name/Version |
| qterminal/zsh | Kali Linux 2022.1 |
| Operating System | Kali Linux |

Resolution

the cursor is of low resolution

2k display

Restore sharp-tailed cursors as separate packages

I like the new more faithful update to the cursor, but the fact it also changed for sizes other than 24 makes it less faithful when taken into account when testing the sizes excluding 24. As a compensation, you can offer the current version of the cursors with the sharp tail in separate packages

Why am i getting a build error even after installing all the prerequisites

After Downloading and entering my dir
When i use the command build
It gives me error called as install not found

I installed all the prerequisites
pls help me

Cannot see crosshair on a dark background

Description of the problem

I can barely see the cursor when taking a screenshot of a portion of the screen on a dark background

How has this issue affected you? What are you trying to accomplish?

It's hard to take screenshots without seeing the cursor

Logs or Screenshots: (optional)

Look at the orange circle

Your Environment

Software	Name/Version
Operating System	Arch Linux
Desktop environment	GNOME 40

Increasing Font Size of the cursors

Description of the problem

How can I increase the font size of the cursor in windows 11 ? that's the only problem I am facing.

How has this issue affected you? What are you trying to accomplish?

Software	Name/Version
Operating System	windows 11

I cant install on mac Os big sur , Why ?

Description of the problem

How has this issue affected you? What are you trying to accomplish?

Logs or Screenshots: (optional)

Your Environment

Software	Name/Version
Operating System

Wrong animation

Both animation files have duplicate frames and are not smooth. I think it's better to create 60 frames, where each frame is 16.66666666666666666 ms (1 jifs) rotated by 6 degrees.

All cursors also don't look clear.

No copy cursor

Even if you did the copy cursor, it isn't in the install for windows folder.

please inform me about how to install this cursor.

Text cursor state

The state the cursor acquires whenever it hovers over text, used to be nicely sized, it became a bit bigger than the cursor in its original state, but this allowed it to still look not to blurry at size 24. However, since your cursor size update, that rectified the issue mentioned in issue #64, however now it has caused (in my opinion) the text state to be a bit too small, and be harder than before to see the details
I don't make cursor themes so I don't know if you can individually edit the sizes of states relative to their counterparts, but I just thought that I should inform you of this.

Design Updates

https://support.apple.com/en-in/guide/mac-help/mh35695/mac

Cursor sizes

How do I set a larger cursor size?

I only see one size in macOSMonterey-Windows:

Custom cursor size build

Hello, please help, I'm trying to build custom size for windows cursor, im trying to build by following your instructions with ctgen and etc, but cursor files automatically resizes to 32x32. I mean, file is for example, have custom size 20x20, but it's blurry because resizes and actual cursor size is same as 32x32. I don't know if i'm doing something wrong, but out folder is creating just size is incorrect. Please help

Minor improvement request

Hi, @KaizIqbal

Big thank you for make a really awesome cursors!
P.S. waited a long time for a good implementation of that cursors for HiDPI displays. 🙃

What about improvement, as I noticed, thickness of fingers on your cursor(hand1, hand2 svgs) seem to be a little thicker than on the original cursors. Can you please check this moment or is it a feature of your cursor set?🙂

Some cursors are very blurry on lower sizes

Description of the problem

As the title says, some of the cursors become very blurry when using sizes lower than 32px. The most affected cursor of this issue is the cross cursor.

How has this issue affected you? What are you trying to accomplish?

I love this cursor set, to the point of using it as my go-to choice. So it's mildly annoying not being able to appreciate them at their best.

Logs or Screenshots:

Your Environment

Software	Name/Version
Pop!_OS	21.04

Please add shadows / Drop-shadows to the arrow cursor

Please add the shadows like the real macos which will make it look better and more cool under light mode too. Bcuz in light mode the arrow cursor looks too dull when the cursor is placed under pure-white areas

Cursor Misaligned

hand cursor seems a bit misaligned with left_ptr

By md93u42 on Pling.com

Wrong hotspot position of Work.ani on Windows platform

Description of the problem

The hotspot position of Default.cur and Work.ani are different, this causes the cursor position to change when the cursor state transitions from "Default" to "Work".

How has this issue affected you? What are you trying to accomplish?

Logs or Screenshots: (optional)

Your Environment

Software	Name/Version
Operating System	Microsoft Windows 11

Blurry mouse cursor (Windows, 4K)

I'm running Windows 10 21H2 on an iMac 4K 2017. The cursor pack appears blurry (might be too low a resolution for 4K).

macOS cursor pack:

Default:

Some Cursors are bigger than others

Adding as a global theme dependency on KDE

Hi Kaiz,

I really liked your work and wanted to add this cursor (the black version) as an auto-magic dependency for a KDE theme so it would be downloaded from the Pling store without user interaction. However, I believe the default download for it is either your source link or the pngs, neither of which function as a cursor theme.

Would it be possible for you to either:

• Make the default download (something like the most recent you've updated on your Pling store page) the black version indefinitely
• Create a new product page that has the black version as the only download

Make Installation Easy 🙏

XCursor

One Command Installation process for Linux with use of curl and wget, Such as Bibata Cursor.

Windows Cursor

Build standard Windows package, So Windows users install it with double-click.Installation process on this article.

Add new Installation Docs to README.md or Wiki Page.

Change cursor theme when "windows theme" changes(automatically).

What is this feature?

Change cursor theme when "windows theme" changes(automatically).

How the feature should work?

windows changes to dark mode(there is alot of application that does this). cursor changes it's theme from light to dark for example

You have examples or an idea of how it can be implemented?

Decrease Cursor border

There's no install.inf file

I'm trying to install the cursors but there's no install.inf file. I downloaded them again and still no such file. Running the command "Start-Process install.inf -Verb Install" another user has suggested also didn't work for me, as it says:

Start-Process : This command cannot be run due to the error: The system cannot find the file specified.
At line:1 char:1
+ Start-Process install.inf -Verb Install

How do I install them in Windows 11?

Cursor tail could be rounded more

On the left is the macOS cursor and on the right is this project's at 24px. The tail for macOS's is noticeably rounder, while this cursor has a portion that "hangs off." I think it looks nicer with the smooth tail at 24px.

Cursor renders too small after upgrade

I'm sorry, I haven't fully had a chance to investigate this.

I upgraded our nixpkgs package from 1.2.0 to 2.0.0 and applied it to my system and my cursor no longer renders at ~2x as I'd expect with my desktop environment (linux, sway).

Any ideas?

Powershell Installation for windows

For some reason right click install didn't work for me, IT group policy maybe. I ran (as admin) in powershell,
Start-Process install.inf -Verb Install
and that was all it took

The windows release doesn't support HiDPI.

Cursor shadow

The cursor shadow makes it look bigger. I don't know how the real apple cursor's shadow looks like but I like the one on the left. I measured both of these cursors(left: El Capitan, right: apple_cursor) and they're both 14px tall. I would like to request for a thinner shadow like the one on the left.

Windows 10

install.inf file not found

can't find this file

build error on windows when using single quotes and spaces (ctgen)

In the readme one of the examples given for building on windows is:
ctgen build.toml -s 16 -p windows -d 'bitmaps/macOS-BigSur' -n 'macOS-BigSur' -c 'macOS Big Sur Windows Cursors with size 16'
However this gives the error:
ctgen: error: unrecognized arguments: Big Sur Windows Cursors with size 16'
If we run this command without the spaces in the comment:
ctgen build.toml -s 16 -p windows -d 'bitmaps/macOS-BigSur' -n 'macOS-BigSur' -c 'bigsur16'

[Warning] The 'win_size' option is deprecated. Please use 'win_sizes' within individual cursor settings or set it to '[cursor.fallback_settings]'. For more information, visit: https://github.com/ful1e5/clickgen/discussions/59#discussioncomment-6747666
[Warning] The 'x11_sizes' option is deprecated. Please use 'x11_sizes' within individual cursor settings or set it to '[cursor.fallback_settings]'. For more information, visit: https://github.com/ful1e5/clickgen/discussions/59#discussioncomment-6747666
[Fail] Error occurred while processing build.toml:
Traceback (most recent call last):
  File "C:\Users\dulve\AppData\Local\Programs\Python\Python312\Lib\site-packages\clickgen\scripts\ctgen.py", line 156, in process
    cfg = parse_config_file(file, **kwargs)
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\dulve\AppData\Local\Programs\Python\Python312\Lib\site-packages\clickgen\configparser.py", line 190, in parse_config_file
    config = parse_toml_file(fp, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\dulve\AppData\Local\Programs\Python\Python312\Lib\site-packages\clickgen\configparser.py", line 148, in parse_toml_file
    cursors = parse_cursors_section(d, config, **kwargs)
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\dulve\AppData\Local\Programs\Python\Python312\Lib\site-packages\clickgen\configparser.py", line 113, in parse_cursors_section
    x11_blob = open_blob(blobs, hotspot, x11_sizes, x11_delay)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\dulve\AppData\Local\Programs\Python\Python312\Lib\site-packages\clickgen\parser\__init__.py", line 22, in open_blob
    return parser(blob, hotspot, sizes, delay)  # type: ignore
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\dulve\AppData\Local\Programs\Python\Python312\Lib\site-packages\clickgen\parser\png.py", line 83, in __init__
    super().__init__(blobs[0])
                     ~~~~~^^^
IndexError: list index out of range

if we then remove the single quotes, it builds successfully:
ctgen build.toml -s 16 -p windows -d bitmaps/macOS-BigSur -n macOS-BigSur -c bigsur16

Windows 11
Python 3.12.1
clickgen 2.2.0

Can't Install on Windows

Description of the problem

Right clicking and selecting "Install" and granting required elevations gives out following error:
The style of INF is different than what was requested.

Logs or Screenshots: (optional)

Your Environment

Windows 10 Pro Build 2004

Cursor is not in expected position

Description of the problem

In v1.1.0 default cursur is not in correct position. I mean top-left of the cursor should be sensitive to pointer position, but in picture as you see, It's not !

Logs or Screenshots: (optional)

Your Environment

Software	Name/Version
Windows	10 19H2
apple cursor.	1.1.0

Arch/AUR installer

Hello,
Thank you for your work on this project.
I would know if it could be possible to create a package for Arch (on AUR for instance) ?
Thanks.

Error while trying to install cursors

Description of the problem

An error happened while trying to install this cursor scheme on my machine.

How has this issue affected you? What are you trying to accomplish?

I was trying to install the cursors. Here's a detailed list of what I did.

1. Installed the latest Windows release file here.
2. Unzipped it using WinRAR.
3. Opened the unzipped folder, and right clicked on the .inf file in order to install it.
4. Got an error saying:
   The INF file you selected does not support this method of installation.
The style of INF is different than what was requested.

Logs or Screenshots: (in french, sorry)

Your Environment

Software	Name/Version
Operating System	Windows 10 (x64/86)

please size 16

please help size 16

Apple Cursor

Hey bro, Awesome work. i created a custom homepage for browsers as iWeb to use like a pro and all in one place with Apple UI system. please use my homepage and give it a try please bro. Kindly star it bro. here's the repo
https://github.com/2k-Aakaash/iWeb
and Deployment also!
https://iweb-homepage.vercel.app/

Build a bigger size for Windows 10

I am trying to create a version of Monterey cursors for Windows with size 48 in Colab:

!git clone https://github.com/ful1e5/apple_cursor.git
%cd /content/apple_cursor
!make windows WIN_SIZE=48

But I get an error:

make[1]: Entering directory '/content/apple_cursor/bitmapper'
make[1]: yarn: Command not found
Makefile:13: recipe for target 'install' failed
make[1]: *** [install] Error 127
make[1]: Leaving directory '/content/apple_cursor/bitmapper'
Makefile:10: recipe for target 'render' failed
make: *** [render] Error 2

Does anyone know how to fix this?

color support?

Description of the problem

Hi,

The readme indicates support for multiple colors, but I can't find evidence of that in the configuration.

Is this already supported? Are you planning to add it?

I want to package this for Nix/NixOS and then make the package overrideable so the user could even pass in their own custom color for a custom build.

Or maybe I can just modify one of the existing black/white config profiles and it will work?

Wrong Link Select icon for Windows (install.inf)

After running install.inf, I noticed that Link Select cursor (Selection de lien in french) is wrong. It should just be the index finger raised and not the whole hand.

Update : I don't know if it's really a bug or not but it happens when I decide to change the theme during or after installation. Restarting the installation without modifying anything resolves the problem

Real Monterey and Big Sur cursors

Your cursors don't look like the real Monterey and Big Sur cursors:

https://support.apple.com/en-za/guide/mac-help/mh35695/12.0/mac/12.0
https://support.apple.com/en-za/guide/mac-help/mh35695/11.0/mac/11.0

**Write** Pling.com Document

its not working for me

i tried all ways

Corner resize cursors are inverted

Description of the problem

The cursors for corner resizing are inverted. Vertical/horizontal cursors are fine though.

How has this issue affected you? What are you trying to accomplish?

Logs or Screenshots: (optional)

Your Environment

Software	Name/Version
Operating System	win10

Uninstalling of Cursor

Description of the problem

Please include guide/steps to Uninstall the Cursor

How has this issue affected you? What are you trying to accomplish?

Unable to uninstall cursor. Wanted to remove the current cursor and install new one, but the steps for uninstalling the cursor cannot be found anywhere online. Moreover, there is no "uninstall" file available for the same. It would be nice to include the steps if not the file to uninstall the cursor.

Logs or Screenshots: (optional)

Your Environment

Software	Name/Version
Operating System	Windows 10

Shadow underneath cursor

What is this feature?

Add a shadow underneath the cursor on KDE Plasma

How the feature should work?

Shadow underneath the cursor

You have examples or an idea of how it can be implemented?

Just add the shadow under the cursor in the bitmaps

Wrong Cursor size

With Version 2.0.1 the Regular Cursor is Large and vice versa on Windows.

Also some seem mixed together like Work.ani appears larger on Regular than Large in the preview.

A large version for these cursors.

Large and maybe extra large version of these cursors.

Same as the others.