Pioneer DJ Setup Guide

TimecodeLink connects directly to Pioneer CDJ and XDJ hardware over your local network using the PRO DJ LINK protocol. No additional software required — just plug in and play.

Supported Hardware

TimecodeLink works with all networked Pioneer DJ players. Newer models provide higher precision updates:

Hardware Precision Update Rate
CDJ-3000 Full ~30ms
CDJ-3000X Full ~30ms
XDJ-AZ Full ~30ms
CDJ-2000NXS2 Standard ~200ms (smoothed by TimecodeLink)
CDJ-2000NXS Standard ~200ms (smoothed by TimecodeLink)
XDJ-XZ Standard ~200ms (smoothed by TimecodeLink)
XDJ-1000MK2 Standard ~200ms (smoothed by TimecodeLink)

Full precision players send position data every ~30ms. Standard precision players update every ~200ms; TimecodeLink smooths the timecode between updates for jitter-free output.

Step 1: Network Setup

Connect your Pioneer hardware and the Mac running TimecodeLink to the same network:

Step 2: Install TimecodeLink

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

On first launch, macOS will ask for permission to find devices on local networks. Click Allow — this is required for PRO DJ LINK device discovery.

Step 3: Select CDJ Input

In TimecodeLink's Input settings, select CDJ/XDJ as the input source. TimecodeLink will automatically discover Pioneer players on your network.

You should see your devices appear in the deck panel within a few seconds. Each player's status (track name, BPM, play state) will update in real-time.

Step 4: Configure Track Mappings

Add tracks to the Track List panel and assign timecode start positions. TimecodeLink matches tracks by the metadata title reported by each CDJ player — ensure your mapping names match the titles stored on your USB drives.

Step 5: Configure Deck Selection

Choose how TimecodeLink determines which deck drives the timecode output:

Troubleshooting

Players not appearing

Verify all devices are on the same subnet. Check that the Mac's firewall allows incoming connections on UDP ports 50000-50002. Try restarting TimecodeLink.

Track names not matching

CDJ players report track titles from the media's metadata. Make sure the track names in TimecodeLink's mapping list match the metadata titles on your USB drives.

Timecode jitter on older hardware

CDJ-2000NXS and similar legacy players send position updates every ~200ms. TimecodeLink smooths this for clean output, but some jitter is normal. For critical applications, use CDJ-3000 or XDJ-AZ hardware.