This is a set of python scripts to participate in a Pioneer ProDJ Link system. It is particularly useful to monitor whats happening on the players, but can also help by syncing other devices using midi clock. The code to detect your own mac and ip addresses is os dependant and only implemented on linux for now.
The Qt GUI is useful to perform light shows and react to events in the music.
These instructions describe necessary work to be done before being able to run the project.
python-prodj-link is written in Python 3. It requires Construct (Version 2.8), PyQt5 and netifaces Use pip or your distributions package management to install these, i.e. on Arch Linux:
pacman -S python-construct python-pyqt5 python-netifaces
Note: Construct is currently (June 2018) undergoing severe API changes. Starting with version 2.9, the new API requires some internal changes in this project. The branch construct-v2.9 contains an updated version which is adapted to newer construct versions. The construct project warns of possible future API changes, thus this version may break with future versions of construct.
You need to be on the same Ethernet network as the players The players will aquire IPs using DHCP if a server is available, otherwise they fall back to IPv4 autoconfiguration. If there is no DHCP server on your network, make sure you assign a IP address inside 169.254.0.0/16 to yourself, for example using NetworkManager or avahi-autoipd.
You can test your setup using wireshark or tcpdump to see if you receive keepalive broadcast on port 50000.
The most useful part is the Qt GUI. It displays some information about the tracks on every player, including metadata, artwork, current BPM, waveform and preview waveform. Waveforms are rendered using OpenGL through Qt, thus you need an OpenGL 2.0 compatible graphics driver. It is also possible to browse media and load these tracks into players remotely. Additionally, you can download tracks from remote players, either directly when loaded or from the media browser.
./monitor-qt.py
The midiclock script opens a midi sound card and outputs midi clock packets matching the current master bpm. This is useful to synchronize beat machines or effect units. To create midi clocks with exact timing, this additionally requires the alsaseq package. Currently, it is required to set the midi sequencer name in midiclock.py as displayed by amidi -l.
./midiclock.py
This is still early beta software! It can freeze your players, although that has not happened to me with the recent versions yet. Be careful when using it in an live environment!
If you experience any errors or have additional features, feel free to open an issue or pull request. As I do only own XDJ-1000 players, I can rarely test the scripts against other players. I have already successfully tested the script against the following players/mixers:
- Pioneer CDJ 2000
- Pioneer CDJ 2000 Nexus
- Pioneer CDJ 2000 NXS2
- Pioneer XDJ 1000
- Pioneer DJM 900 Nexus
- Pioneer DJM 900 NXS2
It may occur that I cannot parse some network packets that I have not seen yet, especially on players other than my XDJ-1000s or if Rekordbox is involved. Please include debug output when reporting bugs and a network dump (i.e. wireshark) if possible.
Licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License inside the "LICENSE" file or at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.