Skip to content

flesniak/python-prodj-link

Repository files navigation

Python ProDJ Link

single player screenshot

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, but thanks to the netifaces it should also work on platforms other than linux (testing required).

The Qt GUI is useful to perform light shows and react to events in the music.

Getting Started

These instructions describe necessary work to be done before being able to run the project.

Prerequisites

python-prodj-link is written in Python 3. It requires Construct (Version 2.9 or later), PyQt5, PyOpenGL and netifaces.

Use your distributions package management to install these, e.g. on Arch Linux:

pacman -S python-construct python-pyqt5 python-netifaces python-opengl

Alternatively, you can use pip to install the required dependencies, preferrably in a virtualenv:

python3 -m virtualenv venv
venv/bin/pip install -r requirements.txt

Note: Construct v2.9 changed a lot of its internal APIs. If you still need to use version 2.8, you can find an unmaintained version in the branch construct-compat.

Testing

python3 test_runner.py

Network configuration

You need to be on the same Ethernet network as the players are discovered using broadcasts. 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.

Usage

Qt GUI

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

or when using virtualenv:

venv/bin/python3 monitor-qt.py

two players screenshot with browser

Midi Clock

The midiclock script opens a midi sound card and outputs midi clock packets matching the current master bpm. Additionally, for each beat a note on event (between 60 and 63) is emitted. This is useful to synchronize beat machines or effect units.

To create midi clocks with exact timing, this additionally requires the alsaseq package. Depending on your distribution you may need to gain privileges to access the sequencer /dev/snd/seq. On Arch Linux, membership in the audio group is required.

By default, the first midi seqencer is used. You can list available ports with argument -l.

./midiclock.py

or when using virtualenv:

venv/bin/python3 midiclock.py

Bugs & Contributing

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. 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.

Acknowledgments

  • A lot of information from dysentery
  • And some info from Austin Wright's libpdjl

License

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.

About

A python interface to Pioneer ProDJ Link

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages