traktor-streaming-proxy

Allow Traktor DJ to stream music from YouTube, Spotify, and Tidal by faking Beatport's API

Traktor DJ supports streaming of music tracks, but only from the Beatport and Beatsource services. This project aims to integrate other streaming sources into Traktor DJ via Beatport Streaming. It consists of an API server based on ktor which fakes some relevant parts of the Beatport API to serve custom content.

Currently, it supports YouTube Music (via NewPipe), Spotify, and Tidal with support for searching for music and browsing saved tracks and playlists. In theory other streaming services or self-hosted sources will be possible to integrate as long as they serve music files in mp4a audio format, since Traktor refuses to load other formats (even though these formats are supported for local files). As a workaround, an on-the-fly format conversion of the music files should be possible at some cost in quality and time.

As with Beatport streaming, Traktor does not allow to use the build-in recorder.

The project now contains a fully crafted Beatport license file that allows the server to handle linking and authentication, with enabling all features such as track analysis and simultaneous playback of multiple decks. You no longer need to take care of the license file or have a Beatport account with subscription! :)

Setup

MacOS

1. Get the latest release and unzip.

2. Configure the server by adjusting the config.properties file. Both Spotify and Tidal sources require an account.

3. (Optional) Install ffmpeg on your system if you want to use the spotify source.

4. SSL trust

Recent versions of Traktor do not trust the generated certificate and refuse to connect to the server. The certificate verification can be bypassed by preloading a small stub library that lets the respective function always pass to effectively disable the check.

You need to create a code signing certificate in Keychain Access -> Certificate Assistant -> Create a certificate ...

Enter a name, e.g. "code", and choose Certificate Type: Code Signing and click Create.

Afterwards resign the Traktor binary with the following command:

sudo codesign --force --sign "code" "/Applications/Native Instruments/Traktor Pro 3/Traktor.app/Contents/MacOS/Traktor"

Then either get the prebuilt stub SecTrustEvaluateStub.dylib from releases or build it yourself:

cd cert
make

5. Run the server from the directory where the config.properties file is located

bin/traktor-streaming-proxy

6. Redirect ports 80 -> 8080 and 443 -> 8443

sudo pfctl -f pf.conf
sudo pfctl -e

7. Redirect api.beatport.com to the server by adding the following to /private/etc/hosts on macOS

127.0.0.1   api.beatport.com

8. Verify that the setup is working correctly

curl -k https://api.beatport.com/v4/catalog/genres/

The result should be a JSON response similar to the following depending on your enabled sources:

{
    "results": [
        {
            "id": 1,
            "name": "YouTube"
        }
    ]
}

If you get an error or something different, it will not work with Traktor and you need to fix your setup.

9. Run Traktor with the following command

DYLD_INSERT_LIBRARIES=./SecTrustEvaluateStub.dylib "/Applications/Native Instruments/Traktor Pro 3/Traktor.app/Contents/MacOS/Traktor"

If you are not yet linked with the server, open settings and connect to Beatport streaming. You should receive an immediate redirect which connects Traktor.

10. Done! If you navigate to Beatport Streaming, you should be able to browse through the predefined categories and use the search box to find content.

Windows

Huge thanks to @v1nc for providing a working setup for Windows and the Traktor patcher!

1. Install Docker desktop with WSL
2. Enable "Start Docker Desktop when you sign in to your computer" in the Docker Desktop settings to make it run at login
3. Start an Ubuntu WSL shell (or your preferred distribution)
4. Clone this repository: git clone https://github.com/0xf4b1/traktor-streaming-proxy.git and navigate to the folder: cd traktor-streaming-proxy
5. Adjust the src/main/dist/config.properties file to your needs. Make sure to change beatport.license to windows and server.useKeystore to true.
6. Generate the required SSL certificates by running ./cert/gen-cert.sh.
7. Trust the generated ./cert/server.crt on your machine: For Ubuntu WSL, go to \\wsl.localhost\Ubuntu\home\username\traktor-streaming-proxy\cert in you explorer, click on server.crt, select Install certificate, select Local computer, click Next, select All certificates and choose Trusted Root Certification Authorities, then install the certificate.
8. Create and start Docker image:

docker build -t traktor-streaming-proxy .
docker run -d --name traktor-streaming-proxy-container -p 443:8443 --restart always traktor-streaming-proxy

9. Make your system use the proxy by appending the following line to your C:\Windows\System32\drivers\etc\hosts file:

127.0.0.1   api.beatport.com

10. You should now be able to open https://api.beatport.com/v4/catalog/genres/ in your browser and see the configured providers without any SSL warnings or errors.
11. Patch Traktor.exe to make it accept the custom beatport license: Run python patch_traktor.py and input the path to your Traktor.exe. If you copy your Traktor.exe to the path mentioned in 7., you can run it in WSL so you don't need to install Python on Windows. After that copy back the patched binary to the Traktor program path. Alternatively, see the notes below to patch it manually.
12. Run the patched Traktor binary, go to settings, streaming and click Login on Beatport. If you just booted your device, wait a minute for the docker container to start. If you start Traktor before the container runs, you will need to click Login to Beatport again
13. Everything should work :)

Notes

the patch_traktor.py script was only tested on Traktor version 4.11.23 but should work on any version that uses the same certificate. If it does not work for you, you can patch the Traktor.exe manually: 1. Download a hex editor like hxd 2. Backup C:\Program Files\Native Instruments\Traktor xx\Traktor.exe and open it with your hex editor 3. Search for -----BEGIN PUBLIC KEY-----. It should be the first occurrence, but verify it is the windows key listed here 4. Replace the key with the mac key listed here. Dots in the hex editor represent new lines, so the best way is to replace the key line per line, leaving the dots where they are. 5. Save the binary, if hxd warns you about a changing binary size, you did something wrong. 6. Copy the binary back to C:\Program Files\Native Instruments\Traktor xx\ if you moved it. Run it to verify it works 7. Obviously you can not use the usual Beatport API with this version

In some Windows installations, Traktor is unable to analyze tracks downloaded from YouTube and fails with an error message:

Cannot execute BPM-detection due to missing transients. Please analyze first

This issue is related to the used codec in the downloaded audio file. We are currently working on a fix.

Library Mapping

Beatport Streaming has the following predefined categories, which we try to match to our available sources in the best possible way. The genres are identical in each category, which is why we use them to differentiate between the sources.

Curated Playlists
- <Genres>         --> source
 - <Playlists>     --> followed artists
  - <Tracks>       --> tracks from artist
Genres
- <Genres>         --> source
 - <Tracks>        --> saved/liked tracks in source
Playlists
- <Playlists>      --> playlists (all sources merged)
 - <Tracks>        --> tracks from playlist
Top 100
- <Genres>         --> source
 - <Tracks>        --> generated playlist of new released tracks