Skip to content

outputsync mac ​

Lines up speakers and headphones when rekordbox plays to two devices, e.g. PC MASTER OUT to Bluetooth speakers with the headphones on a controller.

Platformmac macOS only
GroupBrowsing and playing
Switchoutputsync=0 turns it off (restart rekordbox)

Why ​

Bluetooth sounds a few hundred milliseconds late, so with the master on Bluetooth speakers and the headphone cue on a controller, the headphones ran ahead of the speakers. macOS doesn't line the devices up by itself.

What it does ​

It delays the faster device by the difference the devices report (the log says how much), so speakers and headphones line up. The headphones then lag your hands by the same amount.

The two devices' clocks drift apart only slowly (measured: Bluetooth speakers against an FLX4, 0.3 ms a minute). When rekordbox plays through its own aggregate device, the mod also turns on macOS's drift compensation there, which rekordbox leaves off.

Using it ​

In rekordbox's Preferences > Audio:

  • Line up speakers and headphones: the switch (outputsync_lineup).
  • A fine-tune slider under it, in ms on top of the reported difference (+ = headphones later; outputsync_offset).
  • A metronome switch: clicks on every output, so you can hear whether they line up and tune by ear.

Bluetooth is often later than it reports. Then set outputsync_ms= a number of milliseconds and tune it by ear while both play; it's picked up within seconds.

Options ​

OptionDefaultWhat it does
outputsync10 switches the mod off (restart).
outputsync_lineup1The switch in Preferences > Audio ("Line up speakers and headphones").
outputsync_offset0Fine-tune in ms on top (+ = headphones later): the slider under that switch.
outputsync_msautoauto: as the devices report; a number: delay the faster devices by that many ms (re-read live).
outputsync_clocks01 logs every 30 s how fast each device's clock really runs and how far they drift apart.

Windows ​

macOS only for now: a Windows version needs its own audio device layer.

audiomem · Performance and dropouts

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.