Mac Installation Guide Beta v1.0

Complete step-by-step guide to installing MixMatrix on macOS. Takes about 2 minutes.

Quick Navigation

System Requirements
Step 1: Download
Step 2: Install the App
Step 3: Bypass macOS Security (Gatekeeper)
Step 4: Enter Your Beta License Key
Step 5: Import Your Music
Troubleshooting
Uninstalling

System Requirements

macOS 10.15 (Catalina) or later
Intel or Apple Silicon (M1/M2/M3/M4) - Universal binary included
200MB free disk space
Serato DJ Pro or Rekordbox (optional, for direct library import)

Apple Silicon Users: MixMatrix includes a universal binary that runs natively on both Intel and Apple Silicon Macs. No Rosetta required.

Step 1: Download

Download the DMG File

Download MixMatrix-1.0.0-arm64.dmg from your beta invite email or the downloads section.

The file is approximately 100MB. Save it to your Downloads folder.

Step 2: Install the App

Open the DMG and Drag to Applications

Double-click MixMatrix-1.0.0-arm64.dmg in your Downloads folder
A window will open showing the MixMatrix app icon and an Applications folder shortcut
Drag the MixMatrix icon onto the Applications folder
Wait for the copy to complete (a few seconds)
Eject the DMG by right-clicking it on Desktop and selecting "Eject"

Step 3: Bypass macOS Security (Gatekeeper)

Why this is needed: MixMatrix is not distributed through the Mac App Store and is not code-signed with an Apple Developer certificate during beta. macOS will show a security warning the first time you open it. This is normal for beta software.

First Launch - Method A (Easiest)

Open Finder and go to your Applications folder
Find MixMatrix
Right-click (or Control-click) on MixMatrix
Select "Open" from the context menu
A dialog will appear saying MixMatrix is from an unidentified developer
Click "Open" in the dialog

The app will now open. You only need to do this once - future launches will work normally.

First Launch - Method B (If Method A doesn't work)

If you already tried to open the app by double-clicking and saw "MixMatrix can't be opened":

Open System Settings (macOS Ventura+) or System Preferences (older macOS)
Go to Privacy & Security
Scroll down to the Security section
You should see a message: "MixMatrix was blocked from use because it is not from an identified developer"
Click "Open Anyway"
Enter your Mac password if prompted
Click "Open" in the confirmation dialog

First Launch - Method C (Terminal - Last Resort)

If neither method above works, you can remove the quarantine flag via Terminal:

xattr -cr /Applications/MixMatrix.app

Open Terminal (search for it in Spotlight with Cmd+Space)
Copy and paste the command above
Press Enter
Now double-click MixMatrix in Applications - it should open

Step 4: Enter Your Beta License Key

Activate Your Beta License

When MixMatrix opens for the first time, you'll see a license activation screen.

Find your 25-character license key from your beta invite email
Enter it in the format: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
Click "Activate Beta"
If valid, you'll see a success message and the app will unlock

Lost your license key? Contact support@mixmatrix.io with the email you used to sign up for beta access.

Step 5: Import Your Music

Start Using MixMatrix

You're all set! Now you can import your music library:

Serato DJ: Click Serato > Direct Import - MixMatrix reads your library automatically
Rekordbox 6+: Export as XML from Rekordbox first, then import in MixMatrix
Folder Import: Drag and drop any folder of music files directly into the app

Beta Tip: Start with a smaller subset (100-500 tracks) to test the app before importing your full library.

Troubleshooting

"MixMatrix is damaged and can't be opened"

This usually means the quarantine flag is stuck. Run this in Terminal:

xattr -cr /Applications/MixMatrix.app

Then try opening the app again.

"MixMatrix cannot be opened because the developer cannot be verified"

Follow Method A or Method B in Step 3 above. This is expected for beta software that isn't code-signed.

App crashes on launch

Make sure you're running macOS 10.15 (Catalina) or later
Try deleting app data and restarting:
rm -rf ~/Library/Application\ Support/MixMatrix
Re-download the DMG and reinstall
If the problem persists, send your console logs to support@mixmatrix.io

License key not accepted

Make sure you're entering the key exactly as provided (including dashes)
Keys are case-sensitive - use uppercase letters
Check for extra spaces before or after the key
Each key can only be used on one machine at a time

Serato library not found

Make sure Serato DJ Pro has been opened at least once
Check that your Serato library exists at ~/Music/_Serato_/
If you use a custom Serato location, MixMatrix may not find it automatically

Rekordbox import fails

Rekordbox 6+: You must export to XML first (File > Export Collection in xml format)
Save the XML to your Desktop as rekordbox.xml for automatic detection
Rekordbox 6+ uses an encrypted database that cannot be read directly

Audio preview not working

Check that the audio file exists at the location shown in the track info
Supported formats: MP3, AAC, M4A, FLAC, WAV, AIFF
Some protected files (DRM) cannot be previewed

App is slow or freezing

Large libraries (10,000+ tracks) may take time to load initially
Close other resource-intensive applications
Try restarting the app

How to collect logs for bug reports

Open MixMatrix
Reproduce the issue
Go to View > Developer Tools (or press Cmd+Option+I)
Click the Console tab
Right-click in the console and select "Save as..." to save the log
Email the log file to support@mixmatrix.io

Uninstalling

To completely remove MixMatrix from your Mac:

Quit MixMatrix if it's running
Drag MixMatrix from Applications to Trash
Delete app data (optional - removes all your saved settings and library data):
rm -rf ~/Library/Application\ Support/MixMatrix
Empty Trash

Need help? support@mixmatrix.io