Install
Installing CrateMate
Drag it to Applications, then give it one extra click the first time you open it. About a minute, start to finish.
Why there's an extra step
Apps from outside the App Store are normally notarized: Apple scans them and vouches for the developer. CrateMate isn't notarized yet, so macOS can't check who made it and won't open it with a double-click the first time. You tell it once that you trust the app, and after that it opens like any other.
CrateMate is open source, so you can read every line of what it does on GitHub, or build it yourself.
Step by step
- Open the DMG and drag CrateMate onto Applications.
- Open CrateMate from Applications. The first time, macOS says “Apple could not verify ‘CrateMate’ is free of malware…”. Click Done, not Move to Trash.
- Open System Settings › Privacy & Security. Scroll down to the Security section, where there's a message saying CrateMate was blocked. Click Open Anyway.
- Confirm with your password or Touch ID, then click Open Anyway once more. CrateMate opens.
- Allow Apple Music access. When CrateMate asks to access Apple Music, click Allow. That's how it reads your playlists.
You only need to do this once per version.
On macOS 14 Sonoma you can also right-click CrateMate in Applications, choose Open, then click Open in the dialog. From macOS 15 Sequoia on, use System Settings as above.
If you're comfortable in Terminal
You can skip the Settings round trip by clearing the quarantine flag macOS puts on downloaded apps. Run this after dragging CrateMate to Applications:
xattr -dr com.apple.quarantine /Applications/CrateMate.app
Updating
Download the new DMG and drag CrateMate onto Applications again, replacing the old copy. Your DJ folder and export settings carry over.
Each update asks for Apple Music access again, because macOS sees an unnotarized app's new version as a new app. Click Allow and you're set.
If something's not right
“Couldn't read your Apple Music library”
Allow CrateMate in System Settings › Privacy & Security › Media & Apple Music, then quit and reopen it. If CrateMate isn't listed there, reset the permission so macOS asks again:
tccutil reset MediaLibrary com.bobbyf.cratemate
You can always fall back to a playlist exported from Apple Music as Unicode Text: in CrateMate, choose File › Open Playlist Export… (⌘O).
There's no Open Anyway button
The button only shows for about an hour after macOS blocks the app. Open CrateMate from Applications again, click Done, and go straight back to Privacy & Security.
Still stuck? Open an issue on GitHub with your macOS version and what you see.