Skip to content

Set up the OBS Overlay

Prerequisites

  • DJ Live Playlist is running (the WebSocket server starts with the app)
  • OBS Studio is installed

Add the browser source

  1. In OBS, click + in the Sources list
  2. Choose Browser (Browser Source)
  3. Give it a name, e.g. DLP Overlay

Source settings

SettingValue
URLhttp://localhost:9876/dlp
Width800 px (adjustable)
Height150 px (adjustable)
FPS30

Check "Refresh browser when scene becomes active" to guarantee automatic reconnection.


Position the overlay

In your OBS scene, move and resize the source to your preference. The overlay is transparent by default — it integrates cleanly over your video or background.

Overlay not showing?

Check that DJ Live Playlist is launched before OBS. If OBS was opened first, right-click the source → Refresh.


Customise the appearance

In DJ Live Playlist → ConfigurationOverlay tab:

OptionDescription
ThemeSeveral visual styles available
ArtworkShow / hide album image
QR codeShow / hide QR code
Deck badgeShow / hide deck name
AnimationFade in/out speed and style

Any change is applied in real time in OBS via the CONFIG_UPDATE message.