MaCursor

Cursor Control for macOS

MaCursor gives you control over system cursors on macOS. You can replace macOS cursors with your own artwork or with ready-made themes, fine-tune every detail in the visual editor, and switch between them instantly with global hotkeys.

Requires macOS 15 Sequoia or later.

• 80+ Ready-to-Apply Themes — Browse and download curated cursor themes from the Theme Gallery
• One-Click Apply — Double-click any theme to instantly replace all system cursors
• Convert Windows, Linux & Mousecape Themes — Rebuild a Windows cursor folder (.cur / .ani), a Linux Xcursor theme folder, or a Mousecape .cape file as a native .cursor theme, with every mapped cursor listed for review before it reaches your library
• Full Theme Editor — Create and edit themes with a split-pane editor: metadata, cursor list, per-cursor image slots, hotspot editing, and animated cursor preview
• Live Hotspot Editor — Drag the click point directly on the cursor image and watch the marker follow, with X / Y values updating as you go
• Live Preview — Hover the preview strip to try the cursor for real, click to check where it actually clicks, and see it against black and white side by side
• Windows Cursor Import — Drag & drop .cur and .ani files to import Windows cursors, including animated cursors with sprite sheet composition
• Animated GIF Import — Drop an animated .gif onto a cursor slot and MaCursor builds the sprite sheet and frame timing for you
• HiDPI / Retina Support — Separate 1× and 2× image representations per cursor for crisp rendering on Retina displays
• Cursor Scale — Adjust cursor size from 0.50× to 4.00× with a precision slider (0.1× steps), or type any custom value and press Enter to apply
• Left / Right Hand Mode — Switch cursor orientation for left-handed or right-handed mouse usage directly from Settings
• Global Hotkeys — Assign keyboard shortcuts to favorite themes for instant switching from anywhere
• Background Helper Tool — Lightweight login item (macursorhelper) that keeps shortcuts active and reapplies your theme across user switches
• Auto-Updates — Built-in Sparkle integration for seamless over-the-air updates
• Light / Dark / System Appearance — Full appearance mode control
• 10 Languages — English, Deutsch, Español, Français, Nederlands, Русский, Türkçe, 日本語, 简体中文, العربية
• macOS Tahoe & Golden Gate Ready — Full support for macOS 26 Tahoe and macOS 27 Golden Gate, including automatic handling of new S-variant cursor identifiers

Get up and running in under a minute:

Download the latest .dmg from the Releases page, open it, and drag MaCursor to your Applications folder.

Browse .cursor theme files in the Theme Gallery or grab them all from the Releases page. Already have a Windows or Linux cursor theme? Use File → Convert Theme… instead.

Double-click any .cursor file, drag & drop it onto the MaCursor library window, or use File → Import Theme. Then select the theme and click Apply.

Without the helper tool, cursors reset after a restart or user switch. To keep your theme active permanently:

1. Open MaCursor → Settings → General.
2. Click Install next to Helper Tool.
3. That's it — the helper runs silently at login and reapplies your theme automatically.

Download the latest .dmg from the Releases page. The app ships as a universal binary (Apple Silicon + Intel). Every release is code-signed, notarized, and stapled by Apple.

Select a theme from the sidebar and click Apply, or simply double-click it. The theme persists across app relaunches.

Click the Restore button (↺) in the toolbar to reset all cursors to macOS defaults.

Fine-tune the size of every system cursor from the Settings panel:

1. Open MaCursor → Settings → General.
2. Use the Cursor Scale slider to pick a value between 0.50× and 4.00× (each tick moves in 0.1× increments).
3. For a precise value outside the slider stops, type the desired number directly into the scale field and press Enter to apply.

The new scale takes effect immediately.

Import .cursor theme files by double-clicking, dragging onto the library window, or via File → Import Theme.

Convert Theme rebuilds a cursor theme made for another platform as a native .cursor theme. Three kinds of source are accepted:

1. Choose File → Convert Theme… (⇧⌘O), then select the cursor theme folder or .cape file.
2. MaCursor reads the source and maps each cursor to its macOS counterpart, then opens a review sheet.
3. Check the Mapped list — every cursor that found a macOS slot is shown with its identifier. Open Warnings & ignored to see what was skipped and why.
4. Click Add to Library, or Add & Edit… to go straight into the editor and fine-tune the result.

Theme name and creator are filled in automatically from the source — an .inf file, index.theme, a README, or the cape's own metadata.

Right-click a theme → Edit, or select it and click Edit in the toolbar. The editor opens in a dedicated window with:

Drop .png, .gif, .cur, or .ani files directly onto the representation slots in the editor to add or replace cursor images.

The hotspot is the single point that actually clicks. In the Hot Spot section of the cursor detail pane:

1. Drag anywhere on the cursor image — the marker follows your pointer and the X and Y fields update live.
2. Or type exact coordinates into X and Y for pixel-perfect placement.

The checkerboard behind the image shows transparency, so you can see exactly where the artwork ends.

The Preview strip under the hotspot editor lets you try a cursor before you save it:

• Hover the strip and your real pointer becomes the cursor you're editing.
• Click anywhere to drop a bullseye at the exact point the cursor clicked — the quickest way to confirm the hotspot is right.
• The strip is split black and white, so you can check that light and dark artwork stays visible on both.
• Animated cursors play at their real frame rate while you hover.

macOS 26 Tahoe added S-variant cursor identifiers (ArrowS, IBeamS). MaCursor keeps them in sync for you: whatever you set for Arrow and I-Beam is mirrored into the matching variant, both when a theme is converted and when you edit one.

Open Settings → General and turn off Hide Tahoe cursors if you'd rather see and edit those variants yourself.

1. Open Settings → General → Helper Tool and install the helper.
2. Switch to the Shortcut tab.
3. Add slots, assign a theme and a key combination to each.
4. Press your shortcut from any app to switch cursors instantly.

1. Clone the repository:

   git clone https://github.com/writronic/MaCursor.git
   cd MaCursor/Project

2. Open MaCursor.xcodeproj in Xcode 16+.
3. Build and run the MaCursor scheme.

Contributions are welcome! Please read CONTRIBUTING.md before getting started.

Search existing issues before opening a new one. Use the Bug Report or Feature Request template to ensure your report includes all necessary details.

MaCursor supports 10 languages. Translation files are located in MaCursor/Resources/l10n/ — each language has its own .lproj/Localizable.strings file. Pull requests for new or improved translations are welcome.

Created a theme you'd like to share? Submit it to the built-in gallery — see the contributing guide for instructions.

Fork the repository, create a feature branch, and open a pull request. Please follow the pull request template and keep changes focused.

MaCursor is based on Mousecape, re-engineered with a modernized architecture and native SwiftUI experience.

MaCursor is available under the GPL-3.0 license.