Skip to content

First steps ​

Open platendoos ​

  • macOS: open platendoos from ~/Applications (Finder: Go > Home > Applications). Its icon is rekordbox's, inverted. The first time, macOS asks whether it may use the microphone: click Allow.
  • Windows: start platendoos from the Start menu (or the desktop shortcut).

It's rekordbox, with your own library, playlists and settings. The first launch takes a few seconds longer in the background: the neural networks are loaded one after another (Beat This!, HTDemucs, the genre model, about 6 s together). rekordbox is usable straight away; a track loaded within those seconds waits for the model it needs.

Plain rekordbox is still there

Open rekordbox the usual way whenever you want it without the mods. Don't run both at once.

The PLATENDOOS chip ​

At the bottom left, next to the rekordbox logo, is the PLATENDOOS chip. That's how you tell a modded rekordbox from the plain one.

The PLATENDOOS chip next to the rekordbox logo
  • Hover over it to see rekordbox's and platendoos's versions.
  • Click it for its window.
  • It steps aside the moment rekordbox shows a message in its bottom bar, and comes back when the message is gone.
  • Its blue icon pulses orange when the config file says something else than what is running: a mod was switched on or off. Restart rekordbox to apply it; the tooltip and the window say Restart rekordbox to apply: and list the mods that change.
  • On a rekordbox version platendoos wasn't checked on, it says untested rekordbox build: some mods may be off.

The chip's window ​

The chip's window: rekordbox and platendoos versions, 34 of 34 mods on, and the list of mods
The chip's window: versions, how many mods are on, and each mod's state.

The window shows:

  • rekordbox's and platendoos's versions;

  • how many mods are on, and every mod with its state:

    StateMeaning
    onRunning.
    off in config (name=0)You switched it off.
    on → off after restart, off → on after restartThe config changed its switch; restart rekordbox to apply.
    off: not available in this buildSomething it needs wasn't found in this rekordbox version, so it switched itself off.
  • Restart rekordbox to apply: … when the config changed a mod's switch;

  • Open log and Open config.

Where things are ​

macOSWindows
Config file~/Library/Application Support/rekordbox-mods/config.txt%APPDATA%\rekordbox-mods\config.txt
Log~/Library/Logs/rekordbox-mods.log%LOCALAPPDATA%\rekordbox-mods\rekordbox-mods.log
Caches~/Library/Caches/rekordbox-mods/%LOCALAPPDATA%\rekordbox-mods\cache\

The chip's window opens the log and the config for you.

The config ​

Every mod is on by default. The config is a plain text file that lists every mod and option with its default, each on a line starting with # (remove the # to use it):

ini
# ---- framerate ----
# Only runs the screen at full frame rate while a deck plays or you're using the computer.
#framerate=1
#   seconds without input before the UI drops to 30 fps
#framerate_idle_after=3

Put name=0 on a line to switch a mod off, e.g. framerate=0. Options apply as soon as you save the file (it is re-read every couple of seconds); a mod's own on/off switch applies at the next start of rekordbox. Everything is in Settings and config.txt.

The log ​

Everything the mods do is logged: which mods loaded, what each analysis found, where a deck load's time went, when a cache drive was slow. Its first line says which rekordbox build it is and how the mods found their way around in it:

text
rbmods: rekordbox build 4AF5D59D5EC937DCBD893FBC84D970AD (checked): 420 addresses, 167 fields

Things to try first ​

  1. Analyse a playlist. Right-click a playlist (a Spotify one works too) and choose Open analysis window, then Analyze. See analyzer.
  2. Load an analysed Spotify track. Its waveforms, grid and key are there the moment it's on the deck. See quickdeck.
  3. Sort by two columns. Click BPM, then Key: tracks are sorted by BPM and, within one BPM, by key. See multisort.
  4. Right-click a track. No greyed-out items, and a platendoos submenu with the mods' windows. See tidymenu.
  5. Turn a stem down on a Spotify track. It has stems, which plain rekordbox never gives a Spotify track. See stemcache.

The mods' menus ​

A playlist's right-click menu gets these items; the actions are in the windows they open:

ItemWindowMod
Open analysis windowPlaylist Analysisanalyzer
Open stems windowStem Separationstemcache
Open auto cues windowAuto cuesautocue
Open genres window (local playlists)Genresgenres
The same windows open on just a few tracks: select them in the track list and right-click. With
tidymenu the track menu has a platendoos submenu with Analysis window, Auto cues window,
Stems window and Genres window, and Re-analyze track
(Re-analyze 5 tracks) next to it. The window then lists only those tracks, as "5 tracks from" the playlist, and
everything it does is limited to them.

Mods work on their own: when a feature needs another mod (HTDemucs stems need betterstems), its window says so.

platendoos is an unofficial hobby project, not made by or affiliated with AlphaTheta / Pioneer DJ or Spotify. Licensed under CC BY-NC-SA 4.0.