Rekordbox Setup Guide

TimecodeLink reads playback data directly from Rekordbox's memory. This requires a one-time setup to patch Rekordbox with the necessary entitlements. The app will guide you through this process automatically.

Step 1: Install TimecodeLink

Download and install TimecodeLink from the download page. Drag the app to your Applications folder and launch it.

Step 2: First Launch - Auto-Patching

On first launch, TimecodeLink will detect that Rekordbox needs patching. You'll see a "Setup" button in the status bar. Click it to begin the automatic patching process.

The patching process:

Copies Rekordbox to a temporary folder
Signs it with the get-task-allow entitlement
Replaces the original application

Step 3: Enter Admin Password

The patching process requires administrator privileges to replace the Rekordbox application. Enter your password or use Touch ID when prompted.

Step 4: Launch Rekordbox

After patching completes, launch Rekordbox. TimecodeLink will automatically connect and begin reading deck information. The status bar will show:

Rekordbox: CONNECTED
Deck BPM, position, and track information
Master deck indicator

Step 5: Configure Output

Open Settings to configure your output. For MTC output, enable IAC Driver in Audio MIDI Setup first:

Open Audio MIDI Setup (Applications > Utilities)
Window > Show MIDI Studio
Double-click IAC Driver
Check "Device is online"

Troubleshooting

"Rekordbox Waiting..." status

Rekordbox isn't running, or it needs to be patched. If patching was done, try quitting and restarting both Rekordbox and TimecodeLink.

"Rekordbox setup required"

Click the "Setup" button in the status bar to run the automatic patching process. This is required once per Rekordbox version.

Patching failed

Make sure Rekordbox is not running during patching. Check that you have sufficient disk space for the temporary copy. Try running the patch manually:

codesign --force --deep --sign - --entitlements entitlements.plist /Applications/rekordbox\ 7/rekordbox.app

No data after Rekordbox update

Rekordbox updates require re-patching. The patching process must be repeated whenever Rekordbox is updated. TimecodeLink will detect this and prompt you.