Give your old CDJs a makeover! OneLibraryCompanion (OLC) reads Rekordbox One Library drives (from your CDJs or locally on your Mac/Raspberry Pi), shows your CDJ status in a modern user interface, remotely load tracks to your CDJs even if they don't support new formats (when the USB is mounted on the OLC host), navigates in your library at blazing speed, records your sets' tracklists, and more..
OLC runs on Mac or Raspberry Pi, alongside your players. You keep playback, cueing and mixing on the CDJs. You can use an iPad as the display or any other tablet by connecting to your Mac or RPi via the local network.
- Automatic CDJ discovery: find players on the local network and reconnect when the connection changes.
- Browser audio preview: listen to library tracks on your browser device, with artwork, waveforms and seeking.
- Automatic set capture: record performances automatically, split or join sessions, and keep reusable tracklists.
- Headless Pi controls: restart OLC, shut down the host and safely unmount USBs from MENU.
- Connection reliability: more stable local USB loading and automatic retries for failed analysis reads.
- Other various performance and reliability improvements.
- Follow both decks: live three-band waveforms, track overviews, BPM, pitch, key, master and sync status.
- Plan transitions: see beat and phrase structure, saved cues, loops and the countdown to the next hot cue when the export provides them.
- Find your next track: browse USB libraries and playlists; search, sort and combine BPM, key, genre, rating, color and My Tag filters. Save your favourite filter combinations.
- Keep track of your selections: harmonic-key highlighting helps find compatible tracks, and played-track marks help avoid repeats.
- Load from your library: send a track to a stopped CDJ from a CDJ-mounted USB or a OneLibrary USB connected to the Mac/Pi. Your original music stays unchanged.
- Use more tracks on older CDJs: built-in audio transcoding prepares supported files such as FLAC and ALAC as compatible WAV or AIFF when the destination needs it. No separate converter is required.
- Record and reuse sets: capture your tracklist, edit it, import supported rekordbox histories, revisit past sets as playlists, and export text, CSV or PDF.
- Choose your setup: use the standalone app or a browser on the same network, with mouse, keyboard or touch. Adjust the waveform display, visible filters and track-list size to suit you.
Compare both decks at a glance and see how the tracks fit together. Zoom into the waveforms for the next transition, follow approaching cues and phrases, and switch between elapsed and remaining time. Open track information for artwork and fuller library details.
Explore playlists, narrow your choices with combined filters and save useful searches. Currently playing titles are bright green; previously played titles use softer green. Harmonic key highlighting helps with selection. Press CDJ1 or CDJ2 to load a stopped player; OLC blocks loads when the player is playing or unavailable.
For music attached to the Mac/Pi, both players can use different tracks from the same local USB library. When conversion is needed, OLC prepares the track before loading and shows progress. Local USB and transcoding guide.
OLC captures your tracklist automatically while you play. Edit and share saved sets, or reopen them in BROWSE as playlists. Set history guide.
Screenshots illustrate active sessions. CDJ status uses real exported waveform data; connection and playback states are illustrative.
Download OLC · Installation guide
- Mac: Apple Silicon or Intel, macOS 13 or later.
- Raspberry Pi 4 / 5: Raspberry Pi OS Bookworm or later, 64-bit.
- Install OLC and connect the computer and CDJs to the same network.
- Set up the player connection in MENU and select a library in BROWSE. Local USB loading supports automatic discovery or Manual IP connections, with player number 4 free for OLC; Mac also requires the included Local USB Support installation.
- Keep OLC running and the USB attached while playing. To use OLC from a tablet or any web browser, open the network address shown in MENU in your browser. No login or pairing is needed.
-
Set up a Pi 4 or 5 with 64-bit Raspberry Pi OS Lite Bookworm or later, network access and SSH. Set its hostname to OLC to use the address below.
-
Download the 0.3.0 ARM64 host package from Releases. In its download folder, run these commands over SSH as the ordinary account that will run OLC:
sudo apt install ./onelibrarycompanion-host_0.3.0_arm64.deb sudo loginctl enable-linger "$(id -un)" systemctl --user enable --now olc-host.service hostname -I
-
On another device on the same network, open http://OLC.local:8787. If you chose another hostname, use that name followed by
.local:8787. If the hostname does not resolve, use the Pi’s LAN IP printed byhostname -I, followed by:8787. Configure CDJ connections in MENU and choose your library in BROWSE. -
If using a local music USB, configure it to mount at boot at a stable path readable by that account. Reboot and confirm OLC and the library are available before logging in over SSH.
Use either the desktop app or the headless service on a Pi. Full headless setup, USB mounting and troubleshooting.
The interface uses a fixed 1280 × 800 layout scaled to the display. Downloads are available from the public Releases page.
- Paused non-master waveform tracking is limited. Due to ProDJ Link protocol limitations, the non master player position is updated less often than the master player (1 beat precision). Workarounds: Use the CDJ's display and audio for precise cueing. Temporarily making that player the tempo master can improve tracking.
- One local USB library per connection session. Stop both players and reconnect in OLC before switching local libraries.
- Physical Raspberry Pi, Intel Mac and minimum-OS testing is incomplete. Check compatibility and operating limits before relying on a setup.
Using OLC · Display and filters · Local USB and transcoding · Set history
For contributors: Build guide · Architecture.
OLC is GPL-3.0-only and independent of Pioneer DJ, AlphaTheta and rekordbox. See acknowledgments and source credits. Source and application packages include the applicable licenses.