A free macOS cursor manager that allows you to easily replace Mac system pointers.
Compatible with macOS 26, featuring a fully liquid glass design. Supports one-click conversion from Windows cursor.
English | 中文
The cursor theme "Kiriko" shown in the screenshots is created by ArakiCC, available in the example files.
- Customize Mac system cursors, supporting both static and animated cursors
- One-click conversion of Windows cursor formats (.cur / .ani), mapping 85% of macOS cursor types
- Quickly preview Windows format pointers and support quick preview for macOS.
- Extract default system cursors, perfect for users who prefer older system cursors
- Left-hand mode: mirror cursors horizontally for left-handed users
- Multi-language support: English, Simplified Chinese, Traditional Chinese, Japanese, Korean, German, French
- macOS Sequoia (15) or later
- Support Architectures: runs on both Intel and Apple Silicon Macs (Universal Binary)
Note: The Debug version only includes the architecture of the build machine and may not run on all Macs. For normal use, please download the regular (Release) version.
Download the latest version from the Releases section of this GitHub page.
If you encounter any problems, we recommend that you first check the Troubleshooting section.
Example cursors are located in the Example directory, including the following:
Kiriko.cape: Created by ArakiCC, licensed under CC BY-NC-ND 4.0 (Attribution-NonCommercial-NoDerivs 4.0)
Default_macOS 15.cape: Default cursors extracted from macOS 15 system
Default_macOS 26.cape: Default cursors extracted from macOS 26 system
Windows: Windows version that stores sample cursors
Set Up Launch at Login
- Open the Mousecape app
- Go to Settings > General and enable Launch at Login
When enabled, Mousecape starts in the background at login and provides a menu bar icon that you can use to:
- Open the Mousecape app
- Reset to default system cursor
Note: The Helper always runs in the background for session monitoring. The "Show Menu Bar Tool" toggle only controls the menu bar icon visibility.
Create Custom Cursor Sets/ Import cursor from Windows format
-
Import cursor from Windows format Mousecape supports one-click conversion of Windows cursor themes:
- Extract the downloaded Windows cursor package
- Click the "+" button and select "Import Windows Cursors"
- Select the folder containing the cursor files to import
If the folder contains an
*.inffile, Mousecape will automatically parse it to map cursor files to the correct cursor types. Otherwise, it will use filename-based matching. -
Create Custom Cursor Sets
- Click the "+" button to add a new cursor set
- Click the "+" button to add pointers to customize
- Drag and drop image or cursor files into the edit window
- Adjust hotspot position and other parameters for each cursor
- Save and apply your theme
Modern / Classic Mode
Mousecape offers two display / editing modes, switchable via Settings > Appearance > Display Mode:
- Modern Mode: Displays cursors in 15 Windows cursor groups. Editing one cursor automatically applies changes to all related macOS cursor types in the same group.
- Classic Mode: Edit each of the 52 macOS cursor types individually for full control.
Import/Export .cape Format Cursors (For sharing)
- Click the "Import" button, then select the .cape format cursor file in the Finder window
- Or drag and drop .cape files directly onto the app window to import
- Or double-click a .cape file in Finder to open it directly in Mousecape
- Click the "Export" button, then choose where to save the .cape cursor file
.cape is Mousecape's proprietary cursor format, containing a complete set of cursors in one file
Note: Cape files saved with v1.1.0+ use HEIF image format and may not be compatible with older versions of Mousecape. Existing cape files will be automatically upgraded to the new format when saved.
Reset System Cursor
If you want to revert to the default macOS cursor, you can:
- Click macOS menu bar > File > Reset System Cursor
- Or use the keyboard shortcut Cmd+R
Extract Current Cursor
If you want to extract the cursors currently in use, you can:
- Click macOS menu bar > File > Dump Current Cursor
- Standard image formats: PNG, JPEG, TIFF, GIF
- Windows cursor formats: .cur (static), .ani (animated)
If you encounter issues, please check the common solutions below first. For more help, please submit an Issue.
Due to macOS system limitations, Mousecape has the following restrictions:
Image Size Limit
- Maximum import size: 512×512 pixels (larger images will be rejected)
- All cursor images are automatically scaled to 64×64 pixels at 1x resolution
- If the imported image is larger than 64×64 (up to 512×512), it will be automatically scaled down
- If the imported image is smaller than 64×64, it will be scaled up (may result in lower quality)
Animation Frame Limit
- Maximum 24 frames per animated cursor
- Animated cursors with more than 24 frames will be automatically downsampled
- The downsampling preserves animation timing by adjusting frame duration
Example: A 32-frame GIF animation will be downsampled to 24 frames, and the frame duration will be increased to maintain the original animation speed.
Custom Cursor Only Applied in Mousecape App / Dock Area
Symptoms: The custom cursor only applied in Mousecape app or Dock area, moving out will revert cursor to system default.
Cause: macOS system settings for custom pointer colors can prevent Mousecape from successfully applying cursors globally.
Solution: Reset the system pointer color to the default setting:
- Open System Settings > Accessibility > Display
- Find the Pointer section
- Click the Reset Color button
- Re-apply your cursor theme in Mousecape
The pointer must use the default color scheme (white outline, black fill) for Mousecape to work properly.
Cursor Not Apply in Some Other Apps
Symptoms: Cursor does not take effect inside certain app windows, such as Terminal or Excel.
Cause: Some apps configure their own custom cursors, which override the system cursor settings.
Solution: There is currently no safe workaround. This issue only occurs in certain apps and has limited impact.
MacBook Neo specific
Custom pointers on this model may currently be malfunctioning due to macOS power-saving policies. There are no plans to fix this issue at this time due to a lack of testing devices; we await an official update from Apple. Related discussions
If you like my UI remake, you can support me on Ko-fi :)
- Original project created by Alex Zielenski
- Demo and example cursor "Kiriko" created by ArakiCC
- UI guidance by Winter喵
- SwiftUI interface redesign and Liquid Glass adaptation by sdmj76
- SwiftUI code programming and localization assisted by Claude Code
If you have questions or suggestions, please submit them on GitHub Issues.
This is just a tool, and I've polished its UI. But what matters most is your cursor content :)
English version translated from Chinese by Claude Code
License Notice: This project uses a dual-section license. Alex Zielenski's original code (ObjC model layer, private API layer) remains under its original BSD-like terms. All SwiftUI interface, CLI rewrite, Windows cursor conversion, and documentation by sdmj76 are covered by the Mousecape Non-Commercial License, which prohibits redistribution and requires attribution. Because the compiled application includes both, redistributing the Software as a whole requires compliance with the stricter terms. See LICENSE for full details.