Generate a real time "now playing" track and player information overlays for DJ live streams using PRO DJ LINK Pioneer equipment. Engage your audience and avoid nagging "what track was that!" questions!
Pioneer DJ gear equipped with the PRO DJ LINK feature (see compatible equipment) are able to communicate to each other over a network interface. By reverse engineering this protocol we're able to talk with and understand the information that the CDJs report. We can then use this to generate a customized real time overlay displaying various details about what's happening while a DJ mixes.
This software serves a simple webpage that renders the overlay in real time using ReactJS and websockets which can be overlayed on a video stream using the OBS Browser plugin (or the QT Webkit plugin for Linux).
- Displays live CDJ player status (BPM, pitch, play state, on-air status, sync status).
- Displays metadata of the track currently loaded into the CDJ.
- Delays displaying of track metadata until the track is considered to be "playing" using a combination beat counting and the on-air status reported by the mixer.
- Displays indicator when a new track has been selected.
This project is currently a work in progress. I have not yet added documentation for how to use this software as there are currently no public builds available due to the stability of the software.
Currently various expected functionality is broken due to bugs in the prolink library used to communicate with the equipment. The readme outlines specifics on that project as to what has not yet been implemented.
- Configuration interface for various settings
- Change how many bars until a track is considered playing.
- How many beats can a track be interrupted before the next tracks is considered to be playing.
- Position and style of track details.
- Display waveform for each track, including visual progress indicator for the playing tracks.
- Recognize "mix sessions" by some heuristic allowing track list details to be
stored for that mix session
- Save track lists in various formats, including timestamps.
- Text for soundcloud and youtube
cuefile for association to a recorded audio file- JSON for rendering on a track custom list website
- Indicate on the live stream how many tracks have been mixed and how long the stream has been happening for.
- Save track lists in various formats, including timestamps.
- Live music collection web interface to allow the audience to make live track requests that can then be display in the overlay as being a requested track.
Currently the following Pioneer equipment is confirmed to work:
The following gear also supports the PRO DJ LINK feature and can likely be made to work with this software. However it has not yet been tested. Feel free to reach out if you would like to help to get your equipment working (or if it just works!).