Song requests,
zero friction.
A real-time song request system for DJs. Guests scan a QR code — no app install, no login. DJs manage everything from a live dashboard with automatic track detection.
DJ dashboard — cloud provider status, activity log, and event overview
How It Works
Three simple steps from QR scan to the speakers
Guests Scan
Display a QR code at your event. Guests scan it and instantly land on a request page — no app download, no account needed.
DJ Manages
Incoming requests appear live on your dashboard. Accept, reject, or bulk-approve. Accepted tracks auto-sync to your Tidal and Beatport playlists.
Auto-Detected
The bridge connects to your equipment and detects what you play. When a requested track plays, WrzDJ matches it automatically.
Features
Everything you need to manage song requests at your gigs
Guest Experience
Frictionless for your audience — scan, search, request.
- QR code to join instantly
- Search songs via Spotify with album art
- Submit requests with optional notes
- Upvote other requests to bump priority
- See what's playing now on the kiosk
- Light/dark theme with system preference detection
DJ Dashboard
Tabbed layout keeps song management and event settings separate.
- Dashboard landing page with events, cloud status, and activity log
- Song Management tab: requests, sync report, play history, recommendations
- Event Management tab: kiosk controls, bridge status, cloud providers, banner upload
- Real-time updates via server-sent events — no polling needed
- Multi-service playlist sync (Tidal & Beatport) with smart version filtering
- Guided onboarding tour and contextual help tooltips for new DJs
Kiosk Display
A public full-screen view for your venue's screens.
- Now Playing, Up Next, and Recently Played columns
- Animated audio visualizer and custom banner backgrounds
- QR pairing — scan to link a kiosk to an event, survives power cycles
- Display-only mode for mounted screens; requests-closed banner when the DJ pauses
- Raspberry Pi turnkey setup with WiFi captive portal and crash recovery
Bridge & Track Detection
Plugin system connecting to DJ hardware over the network.
- Denon StageLinQ, Pioneer PRO DJ LINK, Serato DJ, Traktor Broadcast
- Automatic request matching via fuzzy search
- Per-deck state tracking with pause grace periods
- Circuit breaker, auto-reconnect, and track buffer replay for reliability
- Structured logging with debug export for troubleshooting
Stream Overlay (OBS)
Transparent overlay for live streaming via OBS browser sources.
- Now Playing track with album art and LIVE badge
- In Queue list with vote counts
- Fully transparent background for OBS compositing
- Copy overlay URL from the DJ dashboard with one click
- Style via OBS Custom CSS — no code changes needed
Multi-User & Admin
Role-based access control with self-registration support.
- Admin dashboard with user management, stats, and integration health checks
- AI / LLM settings — toggle service, select model, configure rate limits
- DJ self-registration with Cloudflare Turnstile CAPTCHA
- Role-based permissions: Admin, DJ, Pending with last-admin protection
- Per-service enable/disable toggles — database-backed, no restart needed
Screenshots
See WrzDJ in action across every surface
Song management — request queue with BPM, key, and genre metadata, status filters, and AI suggestions
Kiosk display — accepted requests, recently played tracks, QR code, and custom event banner
Guest join page (mobile) — request list with album art, status badges, and upvoting
Events list — your active events at a glance with guided onboarding tour
Admin overview — system stats for users, events, and requests with quick-access management links
User management — role-based filters, approval workflow, and user CRUD
Integrations — enable/disable services, monitor auth and sync status, run health checks
System settings — toggle self-registration, configure search rate limits
OBS stream overlay — Now Playing with album art and In Queue list
Bridge desktop app — event selection, live deck status, and detection settings
Supported Equipment
Connect to the gear you already own
Denon DJ
SC5000 / SC5000M
Prime 4 / Prime 4+
Prime 2 / Prime Go
X1850 / X1800 mixer
Pioneer DJ
CDJ-2000NXS2 / NXS
XDJ-1000MK2 / XDJ-700
DJM-900NXS2 / DJM-750MK2
Ethernet required
Serato DJ
Serato DJ Lite
Any controller or setup
Per-deck track detection
No network config needed
Native Instruments
Traktor Pro 4
Any controller or setup
with broadcast enabled
Built With
Modern, open source technologies
Download WrzDJ Bridge
The desktop app for live track detection. Sign in, pick your event, choose your DJ protocol, and click Start.
The Bridge app connects to a WrzDJ server instance. You'll need to deploy the server backend before the bridge can operate.
Open source · MIT License · Also available via winget install WrzDJ.WrzDJ-Bridge on Windows · View all releases
Open Source
WrzDJ is free and open source under the MIT license. Contributions welcome.
View on GitHub