ful1e5 / apple_cursor

Free & Open source macOS Cursors.

Apple Cursor

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

Join the Community as a Sponsor

Until 2021, my cursor projects were funded through pling.com. However, the funding has since decreased and the projects are now dependent on community support and sponsorships to continue. If you would like to help me maintain Bibata and my other open source projects, you can consider sponsoring my work on GitHub Sponsor or contacting me on Twitter if your company is interested in supporting my projects. I would be happy to discuss it and include your avatar in the project's README.

I am grateful to all the kind individuals and companies that support and sponsor my work, which enables me to continue working on open source projects full-time. Thank you.

---

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

Cursor Sizes

Xcursor Sizes:

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

Windows Cursor Size:

• 16x16 - Small
• 24x24 - Regular
• 32x32 - Large
• 48x48 - Extra Large

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

Notes

• Apple Cursor's build configuration and cursor hotspot settings are bundled in the build.toml file.
• Check out the scripts section in package.json to see how we build the cursor theme, excluding the render scripts. They are useful for converting .svg files to .png files.
• yarn is optional, For building XCursors and Windows cursors from .png files or resizing them you don't need that. If you want to develop/modify Apple Cursor's colors, and bitmaps, or generate a png file from a svg, Then you can use yarn because bitmapper is written in TypeScript.
• Since macOS Bigsur and macOS Monterey are designed similarly, they share the same hotspot settings so a single configuration file build.toml is responsible for building all variants. Due to this, you will have to change the following options in ctgen to build the appropriate variant:
  • -d: bitmaps directory
  • -n: The name you want to give to the generated theme.
  • -c: Theme comment.
  • See ctgen --help for all available options.

Build prerequisites

• Python version 3.7 or higher
• clickgen>=2.1.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 && yarn build
4. See Installing Apple Cursor.

Building

Note Bitmaps are already generated in the bitmaps directory and managed by the maintainer (do not edit them directly).

First make sure you installed the build prerequisites. Now that you have the dependencies, you can try build individual themes from bitmaps and customize sizes, target platform, and etc. with the ctgen CLI (packed with clickgen).

yarn build aberration

Here are the default commands we used to build the macOS variants and packed them into yarn build:

npx cbmp -d 'svg/bigsur' -n 'macOS-BigSur' -bc '#000000' -oc '#FFFFFF'
npx cbmp -d 'svg/bigsur' -n 'macOS-BigSur-White' -bc '#FFFFFF' -oc '#000000'

npx cbmp -d 'svg/monterey' -n 'macOS-Monterey' -bc '#000000' -oc '#FFFFFF'
npx cbmp -d 'svg/monterey' -n 'macOS-Monterey-White' -bc '#FFFFFF' -oc '#000000'

Afterwards, the themes can be found in the themes directory.

Customize Sizes

Note You can change the cursor size up to 200 because pngs are rendered with 200x200. If the cursor is resized by more than rendered png size, the final cursor will be blurred.

Customize Windows Cursor size

To build Windows cursor with size 16:

Warning Windows cursor supports only one size, if multiple sizes are given with -s the first size will be considered in build.

ctgen build.toml -s 16 -p windows -d 'bitmaps/macOS-BigSur' -n 'macOS-BigSur' -c 'macOS Big Sur Windows Cursors with size 16'

You can also customize output directory with -o option:

ctgen build.toml -s 16 -p windows -d 'bitmaps/macOS-BigSur' -o 'out' -n 'macOS-BigSur' -c 'macOS Big Sur Windows Cursors with size 16'

Customize XCursor size

To build XCursor with size 16:

ctgen build.toml -s 16 -p x11 -d 'bitmaps/macOS-BigSur' -n 'macOS-BigSur' -c 'macOS Big Sur 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-BigSur' -n 'macOS-BigSur' -c 'Custom Sizes macOS Big Sur XCursors'

Customize Colors

To customize cursors color you have to install node dependencies with yarn install command. After installing dependencies you can customize the colors via npx cbmp Node CLI App which packed with cbmp node package.

yarn render aberration

Here are the default commands we used for generating the macOS bitmaps and packed them into yarn render:

npx cbmp -d 'svg/bigsur' -n 'macOS-BigSur' -bc '#000000' -oc '#FFFFFF'
npx cbmp -d 'svg/bigsur' -n 'macOS-BigSur-White' -bc '#FFFFFF' -oc '#000000'
npx cbmp -d 'svg/monterey' -n 'macOS-Monterey' -bc '#000000' -oc '#FFFFFF'
npx cbmp -d 'svg/monterey' -n 'macOS-Monterey-White' -bc '#FFFFFF' -oc '#000000'

Examples

Lets generate Big Sur cursor with green base color and black outline:

npx cbmp -d 'svg/bigsur' -n 'macOS-BigSur-Hacker' -bc '#00FE00' -oc '#000000'

After rendering custom color you have to build cursor through ctgen:

ctgen build.toml -d 'bitmaps/macOS-BigSur-Hacker' -n 'macOS-BigSur-Hacker' -c 'Green and black macOS Big Sur cursors.'

Afterwards, Generated theme can be found in the themes directory.

macOS Gruvbox

npx cbmp -d 'svg/monterey' -n 'macOS-Gruvbox' -bc '#282828' -oc '#EBDBB2'
ctgen build.toml -d 'bitmaps/macOS-Gruvbox' -n 'macOS-Gruvbox' -c 'Groovy macOS cursors.'

macOS Solarized Dark

npx cbmp -d 'svg/monterey' -n 'macOS-Solarized-Dark' -bc '#002b36' -oc '#839496'
ctgen build.toml -d 'bitmaps/macOS-Solarized-Dark' -n 'macOS-Solarized-Dark' -c 'Solarized Dark macOS cursors.'

macOS Solarized Light

npx cbmp -d 'svg/bigsur' -n '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/bigsur' -n 'macOS-Dracula' -bc '#282a36' -oc '#f8f8f2'
ctgen build.toml -d 'bitmaps/macOS-Dracula' -n 'macOS-Dracula' -c 'Dracula macOS cursors.'

Contributing

Check CONTRIBUTING.md, any suggestions for features and contributions to the continuing code masterelopment can be made via the issue tracker or code contributions via a Fork & Pull requests.

apple_cursor's Issues

Resolution

the cursor is of low resolution

2k display

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 |

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

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

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?

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

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

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

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.

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

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

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?

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.

Cursor sizes

How do I set a larger cursor size?

I only see one size in macOSMonterey-Windows:

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

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

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

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.

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

**Write** Pling.com Document

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.

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

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?

Some Cursors are bigger than others

The windows release doesn't support HiDPI.

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

Design Updates

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

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/

A large version for these cursors.

Large and maybe extra large version of these cursors.

Same as the others.

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

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

Decrease Cursor border

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.

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

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:

install.inf file not found

can't find this file

please size 16

please help size 16

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

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

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?🙂

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?

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?

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)

Cursor Misaligned

hand cursor seems a bit misaligned with left_ptr

By md93u42 on Pling.com

its not working for me

i tried all ways