Maccy Crashing on Startup? Diagnose and Fix It in Under 10 Minutes

TL;DR: the fastest path

1. Confirm your macOS version meets your Maccy version’s requirement.
2. Quit fully, reinstall a fresh copy into /Applications, and relaunch.
3. Reset preferences with one Terminal command.
4. Move the history store aside (back it up first).
5. Read the crash report to find out what is actually failing.

Is Maccy actually crashing, or just not showing up?

Maccy Mac is a menu bar app. Depending on your settings, it may have no Dock icon and no window at launch, so “nothing happened” is not the same as “it crashed.” Check these first:

• Look in Activity Monitor. If Maccy is listed and its CPU use is normal, it is running. Your menu bar icon may be hidden behind the notch or a menu bar manager.
• Try the shortcut. The default is Shift+Command+C. If the popup appears, Maccy is fine and only its icon is hidden.
• Watch for the quit-after-launch pattern. If the icon appears for a moment and then vanishes, or macOS shows “Maccy quit unexpectedly,” that is a true crash and the steps below apply.

Which fix matches your symptom?

Fix 1: Check that your macOS version supports your Maccy version

Maccy Clipboard 2.x raised the minimum macOS requirement compared with the 0.x and 1.x releases. Today’s builds require a recent macOS release, so an older Mac running a current build may fail to launch.

1. Open Apple menu → About This Mac and note your macOS version.
2. Compare it with the minimum listed on the Maccy releases page.
3. If your Mac cannot run the latest macOS, download an older Maccy release that supports your system instead of the newest one.

The reverse also happens: after a major macOS upgrade, an old Maccy build may misbehave. Updating Maccy fixes that.

Fix 2: Do a clean reinstall

A half-copied app bundle, an app launched straight from the Downloads folder, or a leftover quarantine flag can all cause launch failures.

1. Quit Maccy. If it won’t quit, open Activity Monitor, select Maccy, and click the stop button.
2. Delete Maccy.app from /Applications. This does not delete your history or settings.
3. Reinstall using whichever method you originally used:
   • Homebrew: brew reinstall --cask maccy
   • GitHub release: download the latest .zip, unzip it, and drag Maccy.app into /Applications (not Downloads).
   • Mac App Store: reinstall from your purchases.
4. Launch it from /Applications.

If macOS reports the app is damaged or from an unidentified developer, right-click the app, choose Open, and confirm. You can also approve it under System Settings → Privacy & Security, where a blocked app is listed near the bottom. Only do this for a copy you downloaded from the official GitHub releases or the App Store.

Fix 3: Reset Maccy’s preferences

A corrupted preferences file is a classic cause of a crash that repeats on every launch. Resetting it returns Maccy to default settings without touching your clipboard history.

1. Quit Maccy.
2. Open Terminal and run:

   defaults delete org.p0deje.Maccy

3. Relaunch Maccy.

You will need to re-enter any custom shortcut, ignore list, and display settings. If the command reports that the domain doesn’t exist, you are likely running the sandboxed App Store build, whose preferences live inside its container. In that case, move on to Fix 4 or the crash-report step.

Fix 4: Move the history store aside

Maccy keeps clipboard history in a local database. If that database is damaged, for example after a forced shutdown or a disk full event, Maccy can crash while loading it. Instead of deleting it, move it somewhere you can restore it from.

1. Quit Maccy.
2. In Finder, choose Go → Go to Folder… (Shift+Command+G).
3. Open the storage location for your install type: ~/Library/Application Support/Maccy for the direct download or Homebrew build, or the equivalent folder inside ~/Library/Containers/org.p0deje.Maccy for the App Store build.
4. Drag the Maccy data files to your Desktop as a backup.
5. Relaunch Maccy. It will create a fresh, empty history.

If Maccy now launches normally, the old store was the problem. Your pinned items and history from the backup may be partially recoverable, but expect to start fresh. If it still crashes, restore the files and continue to the next step so you don’t lose data for nothing.

Fix 5: Read the crash report

When the quick fixes fail, the crash report tells you what actually broke. It takes two minutes.

1. Open Console.app and select Crash Reports in the sidebar. You can also browse ~/Library/Logs/DiagnosticReports.
2. Open the newest report with “Maccy” in its name.
3. Check three fields: Exception Type, Termination Reason, and the stack on the Crashed Thread.

If the cause is unclear, attach the report when you file an issue (see below). Remove any personal details first, since reports can include file paths with your username.

Fix 6: Launches fine, but pasting doesn’t work

This is the most common “Maccy is broken” report that isn’t a crash. To paste directly into other apps, Maccy needs the Accessibility permission. Open System Settings → Privacy & Security → Accessibility, make sure Maccy is listed and enabled, and toggle it off and on if it already appears enabled. After an app update or reinstall, macOS sometimes treats the new binary as a different app, so removing the old entry and re-adding Maccy often clears the problem.

Could another app be causing the crash?

Possibly. Maccy watches the system pasteboard, so other clipboard-aware software can interact with it. If a crash began right after you installed a second clipboard manager, a text expander, or a password manager with clipboard features, temporarily quit that app and launch Maccy again. Running two clipboard managers is rarely worth the trouble. Also check whether a security or “cleaner” utility flagged Maccy and quarantined part of it.

How do I stop it from happening again?

• Keep Maccy updated. Startup crashes tied to new macOS releases are usually fixed in point releases.
• Run it from /Applications. Apps run from Downloads or a disk image are more likely to hit quarantine and update problems.
• Avoid force-shutting down mid-copy. Abrupt power loss is the likeliest way to corrupt any local database.
• Back up the storage folder occasionally if your history or pins matter to you.

Still crashing? Report it usefully

Maccy is open source, so a good bug report directly speeds up the fix. Open an issue on the Maccy GitHub repository after searching existing issues for your symptom. Include your macOS version, Maccy version and install method, the steps you already tried from this guide, and the redacted crash report. A report with that information is far more likely to get a response than “it crashes.”

Frequently asked questions

Why does Maccy crash right when I open it?

The most common causes are a macOS version below the minimum for your Maccy build, corrupted preferences, a damaged clipboard history database, or a broken install. Resetting preferences and reinstalling from /Applications resolves most cases.

Will I lose my clipboard history if I reset Maccy?

Resetting preferences does not delete history. Moving the history store aside starts a fresh history, which is why you should copy the old files to a backup location first.

How do I fully uninstall and reinstall Maccy?

Quit the app, delete Maccy.app, optionally remove its preferences with defaults delete org.p0deje.Maccy and its storage folder, then reinstall from Homebrew, GitHub, or the App Store.

Is Maccy still running if I can’t see the menu bar icon?

It may be. Check Activity Monitor and try the default Shift+Command+C shortcut. A crowded menu bar or the MacBook notch can hide the icon even when the app is healthy.

Where can I find Maccy’s crash logs?

Open Console.app and select Crash Reports, or browse ~/Library/Logs/DiagnosticReports for files with “Maccy” in the name.

Wrapping up

Start with the cheap, reversible fixes (version check, clean reinstall, preferences reset), and only then touch the history store, always with a backup. If you’re still stuck, the crash report almost always names the culprit. Once Maccy is stable again, it’s worth spending a minute tuning what it ignores. Which apps’ copies do you least want in your history?