> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apex-services.site/llms.txt
> Use this file to discover all available pages before exploring further.

# APEX DJ Pult

> Spatial YouTube playback booth with queue and volume control.

A DJ booth with spatial audio playback for FiveM. Queue YouTube tracks, control volume and playback distance, and broadcast to everyone in range via xsound — built for clubs, bars, and event venues.

## Features

* Spatial playback via xsound — 3D audio that fades with distance
* YouTube queue — up to 30 tracks per session, 30 per playlist
* Volume + distance sliders live during playback (default 50m radius)
* Domain whitelist — only YouTube URLs allowed by default
* Clean DJ booth NUI with queue and controls
* Configurable marker + blip for the booth
* Drop-in — no ESX dependency wiring

## Requirements

<Card title="Required" icon="circle-check">
  `ox_lib`, `oxmysql`, `xsound`
</Card>

## Configuration

```lua config.lua theme={null}
Config.MaxSongs            = 30
Config.MaxSongsPerPlaylist = 30
Config.DefaultVolume       = 0.5
Config.DefaultDistance     = 50
Config.AllowedDomains      = { 'youtube.com', 'youtu.be', 'www.youtube.com' }
Config.InteractionDistance = 2.0
```

Blip and marker visuals are fully configurable. The domain whitelist prevents random URL abuse.

## Resource info

<Note>
  Code accessible: `config.lua`, `html/*`. Approximately 400 lines of Lua + NUI. Framework-agnostic. German.
</Note>