Skip to content

Settings and config.txt ​

Every mod is on by default. Settings live in one plain text file:

PlatformFile
macOS~/Library/Application Support/rekordbox-mods/config.txt
Windows%APPDATA%\rekordbox-mods\config.txt

The PLATENDOOS chip's window opens it (Open config). The patcher writes your mod choices into it when you install.

How the file works ​

The mods create it on the first start. It lists every mod and option this platform has, with its default, each on a line starting with #, which means off: remove the # to use a line, then change its value.

ini
# ---- stemcache ----
# Keeps rekordbox's separated stems on disk, so a track you've had on a deck before has its stems
# ready at once instead of separating again.
#stemcache=1
#   delete the least recently used chunks above this size (0 = no limit)
#stemcache_max_gb=10

To keep at most 30 GB of stems:

ini
stemcache_max_gb=30

To switch a mod off:

ini
framerate=0

When a change applies ​

  • Options apply as soon as you save the file: it is re-read every couple of seconds.
  • A mod's own on/off switch (name=0 / name=1) applies at the next start of rekordbox: which mods are on is decided once, when rekordbox starts. When the file says something else than what is running, the PLATENDOOS chip's blue icon pulses orange, and its tooltip and window say Restart rekordbox to apply: … and list the mods that change.
  • A few options say restart or from the next launch in their description (for example gpu, spotifyapi_slots and audiomem's parts): those are read once too.

The patcher's checkboxes and the config are the same thing: unticking a mod in the patcher writes <mod>=0, and the patcher's window starts from what the config says.

Other settings ​

SettingPlatformWhat it does
worker_priorityWindowsThe mods' own threads run one step below normal priority, so rekordbox's window and drawing go first. -1 (default), 0: normal, as before 0.3.0; -2: two steps down. The default is 0 on a PC with fewer than four logical cores.
column<id>=WindowsWritten by the mods: where the mods' own track list columns (Key @ Master, CNN Key, BT BPM) are, since rekordbox's saved layout doesn't know them.
analyze_playlistbothWritten by the analyzer: the playlist analysed last, reopened after a restart.

Lines the mods write themselves aren't meant to be edited.

Every option ​

Generated from the defaults the mods carry (core/config_template.h in the repository). Mods marked mac exist on macOS only, win on Windows only; a few defaults differ per platform.

analyzer ​

Open analysis window in any playlist's menu analyses that playlist, Spotify ones too. More →

OptionDefaultMeaning
analyzer10 switches the mod off, 1 on. Applies after a restart of rekordbox.
analyze_decks3,4decks to use when analyze_direct=0 (1-4)
analyze_direct1analyse without decks (0: load onto the decks below)
analyze_fast01: tracks this mod loads skip rekordbox's optional analyses (phrase, vocal detection, similarity embedding); rekordbox adds those later, when the track is loaded for playing
analyze_gap4min seconds between two loads (spares the streaming service)
analyze_import1direct mode: import a Spotify playlist track that isn't in the collection yet (like playing it does), since rekordbox only analyses collection tracks; 0: such tracks fail
analyze_import_timeout20seconds to wait for an imported track to show up in the collection
analyze_live1tracks analysed at once while a deck is playing (0: the run waits for the decks to stop)
analyze_min_free_gb5stop a run when the disk has less free space than this (at most 1 when no Spotify audio is kept on disk)
analyze_parallel6tracks analysed at once in direct mode (6 is fastest on a 10-core Mac)
analyze_reopen1open the playlist analysed last after a restart (analyze_playlist, saved when a run starts)
analyze_start_timeout15seconds before a track whose analysis never starts is retried
analyze_streams3max Spotify tracks loaded at once, counting all decks
analyze_timeout90 (macOS), 180 (Windows)seconds before a track that never finishes is given up (180 on Windows)
analyze_window1open the analysis window when a run starts
bettergrid_min_fit0.6Beat This!'s fit below which rekordbox's grid is kept
genres_on_analyse01: fill empty Genre fields when rekordbox analyses a track

artcache ​

Remembers far more cover art, and keeps Spotify covers on disk, so scrolling and loading decks don't download the same images over and over. More →

OptionDefaultMeaning
artcache10 switches the mod off, 1 on. Applies after a restart of rekordbox.
artcache_mb256memory cache size in MB

audiomem mac ​

Keeps the memory rekordbox's audio works with in RAM, so playback doesn't click when the Mac runs short of memory (macOS). More →

OptionDefaultMeaning
audiomem10 switches the mod off, 1 on. Applies after a restart of rekordbox.
audiomem_ahead20seconds of audio kept ready ahead of a playing deck
audiomem_code10 switches one part off: keeping rekordbox's own code and data in memory (restart).
audiomem_decks10 switches one part off: keeping the next seconds of every loaded deck ready (restart).
audiomem_fx10 switches one part off: pinning the FX history buffers (restart).
audiomem_lazy10 switches one part off: deck loads that don't clear the new buffers on the main thread (restart).

autocue ​

Sets hot cues A–H (intro, build, drop, breakdown, build 2, drop 2, outro, fake drop) on a playlist, Spotify tracks too (read from the stream into memory by spotifyaudio). More →

OptionDefaultMeaning
autocue10 switches the mod off, 1 on. Applies after a restart of rekordbox.
autocue_claude_modelhaikuClaude Code's model (an alias or a full name)
autocue_claude_path(empty)the claude program, if it isn't found by itself
autocue_modelanthropic/claude-haiku-5.5any model id from openrouter.ai/models
autocue_parallel3tracks analysed at once (one of them separates stems at a time)
autocue_provideropenrouteror claude: the local Claude Code CLI
autocue_stems10 analyses three bands of the mix instead of stems (faster: no separation)

badge ​

The PLATENDOOS chip: its window shows the versions, every mod and whether it's on, and opens the log and this file. More →

OptionDefaultMeaning
badge10 switches the mod off, 1 on. Applies after a restart of rekordbox.

betterfx mac ​

Better-sounding mixer effects (macOS). More →

OptionDefaultMeaning
betterfx10 switches the mod off, 1 on. Applies after a restart of rekordbox.
betterfx_echo1Echo and Pitch Echo: no dips while the tempo changes
betterfx_eq1the DJM-900NXS2 EQ and the isolator
betterfx_filter1the Color FX Filter (the FLX4 filter knob)
betterfx_reverb1the Beat FX Reverb (the new reverb sound)
betterfx_roll1Roll, Reverse Roll and Slip Roll: no dip on every repeat

bettergrid ​

Better beat grids: combines the Beat This! beat tracker's tempo and bar starts with beats placed on the hits in the audio. More →

OptionDefaultMeaning
bettergrid10 switches the mod off, 1 on. Applies after a restart of rekordbox.
bettergrid_apply10: compare only, log both grids and keep rekordbox's
bettergrid_bars1rekordbox's and Beat This!'s bar starts differ: the music's changes (barphase.h) pick one; 0 the kick-in rule alone
bettergrid_debug01 logs the beats of both grids (for debugging)
bettergrid_genre1the track's genre (genres mod) picks the tempo's octave; 0 never
bettergrid_halfbeat1rekordbox's beats half a beat off the beat: 1 moved when Beat This!'s beats and the kick band (its onsets, or its level clearly higher between) both say so, 2 when Beat This!'s beats alone say so, 0 never
bettergrid_rb_first10: while it waits, the deck doesn't show rekordbox's own grid meanwhile (quickdeck)
bettergrid_slow0Windows: 1: also wait for Beat This! for a track on a deck where it is slow (it runs on the CPU, or on a GPU that needs over a second for 30 s of audio)
bettergrid_titleBT BPMheader name of the column
bettergrid_wait20 (macOS), 60 (Windows)seconds the analysis waits for the combined grid at most (60 on Windows)
bettergrid_warmup10: no first run of the model at launch (macOS)
gpu1macOS: 0 keeps bettergrid on the CPU. Windows: 0 keeps the models off the GPU: Beat This! and the genre model run on the CPU, stems come from rekordbox's own engine

betterkey ​

Detects musical keys with a neural network trained for it, which gets keys right more often than rekordbox's built-in detector: 67.5 % of the GiantSteps key dataset's tracks against rekordbox's 56.8 %. More →

OptionDefaultMeaning
betterkey10 switches the mod off, 1 on. Applies after a restart of rekordbox.
betterkey_min_conf0replace only when the CNN's probability is at least this (0..1)
betterkey_modecomparecompare: keep rekordbox's key, log both; replace: use the CNN's key
betterkey_titleCNN Keyheader name of the column
betterkey_wait120seconds the key stage waits for the CNN's result before it keeps rekordbox's key
streamio_phrase10 reads the audio again for phrase analysis

betterstems ​

Separates stems with HTDemucs v4 instead of rekordbox's own engine: cleaner stems (about 9 dB SDR against Spleeter's 5.8), on the GPU, about 1 s per 12 s of audio. More →

OptionDefaultMeaning
betterstems10 switches the mod off, 1 on. Applies after a restart of rekordbox.
betterstems_grid_first10: stems of a track that is being analysed start at once, next to its beat detection
betterstems_live_rest0while a deck plays: a rest after each model segment, this many times the segment's own time (1 = the stems take twice as long and the GPU is free half the time)
betterstems_slow0Windows: 1: HTDemucs also where it is slow (on the CPU, or on a GPU that needs over a second for a segment); 0: rekordbox's own engine separates there
betterstems_warmup10: no first run of the model at launch (macOS)

fastwave ​

The deck waveforms come back sooner after they change, e.g. when you mute or unmute a stem or load a track. More →

OptionDefaultMeaning
fastwave10 switches the mod off, 1 on. Applies after a restart of rekordbox.
fastwave_ms30wait before rebuilding a waveform (rekordbox's own is 500)

flx4 ​

DDJ-FLX4 as a four-deck controller with stems. More →

OptionDefaultMeaning
flx410 switches the mod off, 1 on. Applies after a restart of rekordbox.
flx4_deviceDDJ-FLX4MIDI device to map (for testing with another device using the same mapping)
flx4_keep_tempo10: a deck a side switches to takes the tempo rekordbox remembers its fader at
flx4_log01 logs every MIDI message in and out
flx4_meterlog01 logs the level meters (for debugging)
flx4_mixer(empty)fixed keeps the mixer channels on decks 1/2

fontcache mac ​

Makes drawing text, most of the work when the track list repaints, a lot cheaper. More →

OptionDefaultMeaning
fontcache10 switches the mod off, 1 on. Applies after a restart of rekordbox.

framerate ​

Only runs the screen at full frame rate while a deck plays or you're using the computer. More →

OptionDefaultMeaning
framerate10 switches the mod off, 1 on. Applies after a restart of rekordbox.
framerate_idle_after3seconds without input before the UI drops to 30 fps

genres ​

Fills the Genre field from what the music sounds like: a style model (Discogs-EffNet from Essentia, 400 Discogs styles, best with electronic music) listens to each track. More →

OptionDefaultMeaning
genres10 switches the mod off, 1 on. Applies after a restart of rekordbox.
genres_detailstylestyle: the specific style ("Deep House"); broad: the broad genre ("House")
genres_warmup10: the style model loads when it is first needed, not at launch

keepmaster ​

Changing the sync master never changes the tempo of a deck you hear. More →

OptionDefaultMeaning
keepmaster10 switches the mod off, 1 on. Applies after a restart of rekordbox.

keycolumn ​

A new Key @ Master column: each track's key as it would sound at the master deck's tempo, e.g. 8A +1.2. More →

OptionDefaultMeaning
keycolumn10 switches the mod off, 1 on. Applies after a restart of rekordbox.
keycol_titleKey @ Masterheader name of the column

midipoll mac ​

Checks for newly plugged-in MIDI controllers every 2 seconds instead of every 0.3 seconds, and quickly again whenever something is plugged in. More →

OptionDefaultMeaning
midipoll10 switches the mod off, 1 on. Applies after a restart of rekordbox.

multisort ​

Sort the track list by several columns: each click on a column header cycles it through ascending, descending and off, and the columns that are on sort together in the order you turned them on (e.g. BPM, then key within each BPM). More →

OptionDefaultMeaning
multisort10 switches the mod off, 1 on. Applies after a restart of rekordbox.

outputsync mac ​

Lines up speakers and headphones when rekordbox plays to two devices (in rekordbox's Preferences > Audio: a switch, a fine-tune slider, and a metronome that clicks on both outputs so you can tune by ear), e.g. PC MASTER OUT to Bluetooth speakers with the headphones on a controller. More →

OptionDefaultMeaning
outputsync10 switches the mod off, 1 on. Applies after a restart of rekordbox.
outputsync_clocks0log every 30 s how fast each device's clock really runs and how far they drift apart (measured: Bluetooth speakers vs an FLX4, 5 ppm = 0.3 ms a minute)
outputsync_lineup1the switch in rekordbox's Preferences > Audio ("Line up speakers and headphones")
outputsync_msautoauto: as the devices report; a number: delay the faster devices by that many ms (tune while listening to the speakers and headphones together; re-read live)
outputsync_offset0fine-tune in ms on top (+ = headphones later), the slider under that switch; there too a metronome switch: clicks on every output, to hear whether they line up

parallel ​

Spreads the heaviest part of analysing a track over three cores instead of one. More →

OptionDefaultMeaning
parallel10 switches the mod off, 1 on. Applies after a restart of rekordbox.

quickdeck ​

A Spotify track (or any track that isn't analysed yet) shows its waveforms and a beat grid on the deck as soon as the analysis has them, instead of only when the whole analysis is done. More →

OptionDefaultMeaning
quickdeck10 switches the mod off, 1 on. Applies after a restart of rekordbox.
quickdeck_merge0.25Windows: seconds the waveforms wait for rekordbox's own grid, so that one redraw of the deck shows both (0: no wait)

screeninfo mac ​

Stops rekordbox from asking macOS about your screen on every single redraw. More →

OptionDefaultMeaning
screeninfo10 switches the mod off, 1 on. Applies after a restart of rekordbox.

spotifyapi ​

Lets rekordbox load several Spotify track lists at once instead of one after the other. More →

OptionDefaultMeaning
spotifyapi10 switches the mod off, 1 on. Applies after a restart of rekordbox.
spotifyapi_slots3Spotify lists loaded at once (applies from the next launch)

spotifyaudio ​

Reads a Spotify track's audio from the stream into memory when autocue's or genres' window needs to hear the whole track, the way rekordbox's own analysis reads it. More →

OptionDefaultMeaning
spotifyaudio10 switches the mod off, 1 on. Applies after a restart of rekordbox.
spotifyaudio_mb256memory for the tracks decoded last (0: none kept)
spotifyaudio_wait90seconds to keep trying to open a track's stream (Spotify's streaming limit)

spotifydl ​

Logs where a Spotify track's load time goes: slow or failing requests and how long each download took. More →

OptionDefaultMeaning
spotifydl10 switches the mod off, 1 on. Applies after a restart of rekordbox.
spotifydl_debug0also log every audio piece, and the first audio answer in full

spotifyfix ​

Stops Spotify playlists from endlessly reloading themselves, and fixes a deadlock in rekordbox's Spotify client that could freeze every Spotify download until you force quit (a token refresh colliding with a playlist refresh). More →

OptionDefaultMeaning
spotifyfix10 switches the mod off, 1 on. Applies after a restart of rekordbox.

spotifylog ​

Stops rekordbox from rewriting its Spotify log file several times a second while it syncs. More →

OptionDefaultMeaning
spotifylog10 switches the mod off, 1 on. Applies after a restart of rekordbox.

spotifystart win ​

Fixes Spotify hanging on "loading the library" after a restart. Only does anything on rekordbox 7.2.19 for Windows. More →

OptionDefaultMeaning
spotifystart10 switches the mod off, 1 on. Applies after a restart of rekordbox.

stemcache ​

Keeps rekordbox's separated stems on disk, so a track you've had on a deck before has its stems ready at once instead of separating again. More →

OptionDefaultMeaning
stemcache10 switches the mod off, 1 on. Applies after a restart of rekordbox.
stemcache_dir(empty)folder of the cached stems (empty: the default one)
stemcache_max_gb10delete the least recently used chunks above this size (0 = no limit)
stemcache_memory_mb384Spotify tracks' stems kept in memory (never on disk) for loading them again in this session; the least recently used go first (0: none)
stemcache_min_free_gb5store nothing new while the disk has less free space than this
stemcache_quality256how new chunks are stored: lossless | 256 | 192 | 128 (AAC kbps per stem)
stemcache_spotify1no stems for Spotify tracks (otherwise: on a deck at once, separated from the stream)
stemcache_stagingautonew chunks go to the internal disk first (<the mods' cache folder>/stems-staging) and one background thread moves them to stemcache_dir, a piece at a time and never while a deck or an analysis reads from that drive. auto: only when stemcache_dir is on an external drive | 1: always | 0: never
stemcache_staging_gb4how much may wait on the internal disk; past it a deck's chunks are left out (separated again the next time) and the stems window's run waits

streamio ​

Reads the audio faster during analysis: about 10% faster overall and 4x faster phrase analysis. More →

OptionDefaultMeaning
streamio10 switches the mod off, 1 on. Applies after a restart of rekordbox.

tfpool ​

Keeps rekordbox's beat-detection neural network loaded between tracks instead of reloading it for each one. More →

OptionDefaultMeaning
tfpool10 switches the mod off, 1 on. Applies after a restart of rekordbox.
tfpool_warmup10 skips loading and running rekordbox's beat model once at launch (macOS)

tidymenu ​

A calmer right-click menu on tracks. More →

OptionDefaultMeaning
tidymenu10 switches the mod off, 1 on. Applies after a restart of rekordbox.
tidymenu_group10: the mods' items stay in the menu itself, under their long names
tidymenu_hide10: rekordbox's greyed-out items stay
tidymenu_log01 logs the items of each menu shown (for debugging)

timing ​

Logs how long each step of an analysis takes. More →

OptionDefaultMeaning
timing10 switches the mod off, 1 on. Applies after a restart of rekordbox.

xfadelock mac ​

A small lock button next to the on-screen crossfader holds the crossfader exactly in the middle (macOS). More →

OptionDefaultMeaning
xfadelock10 switches the mod off, 1 on. Applies after a restart of rekordbox.

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.