🎛️ Operator Setup Guide

Everything a DJ or venue operator needs to go live in under 5 minutes — software, audio routing, QR codes, and channels.

Setup Guide WiFi Guide DJ Guide
DJ Controller
🎛️

OPERATOR SETUP GUIDE

Everything the venue operator or DJ needs to go live in under 5 minutes.

1

INSTALL THE APP

Download Silent Disco WiFi for macOS and open it. No configuration wizard, no command line. The admin dashboard opens automatically in your browser.

  • Runs on macOS 12 or newer — MacBook, Mac mini, or iMac
  • Connect the Mac to the venue router via Ethernet (WiFi works too)
  • No external server or cloud account required — runs 100% locally
2

VIRTUAL AUDIO CABLES AUTO-INSTALL

On first launch the app silently installs BlackHole — a virtual audio cable that lets any app on your Mac send its audio to a Silent Disco channel. No downloads or settings needed from you.

  • Three isolated virtual cables — one per channel (Blue / Red / Green)
  • Route Spotify, DJ software, a media player, or any system audio to any channel
  • Works alongside your existing audio setup without conflicts
3

SELECT YOUR AUDIO SOURCE PER CHANNEL

Each of the three channels can use a different source simultaneously.

📁

Folder / AI DJ

Point a channel at a folder of MP3s. The built-in player auto-shuffles and crossfades all night — no manual DJ required.

  1. Open admin → DJ Player section
  2. Click Browse… and pick your music folder
  3. Set crossfade time (default 4s)
  4. Click Start — the AI DJ takes over
🎵

Single Track / Loop

Load one MP3, WAV, FLAC, or AAC file and loop it. Perfect for a branded sound or a pre-mixed set.

  1. Open admin → DJ Player section
  2. Click Upload Track
  3. Toggle Loop on
  4. Click Play
Live DJ
🎚️

USB Audio Input

Plug in your DJ controller, mixer, or USB audio interface. The software detects it and streams the live mix directly to that channel.

  1. Plug USB audio device into the Mac
  2. Open admin → Audio Inputs
  3. Click ↺ Refresh Devices
  4. Pick your device, set L/R channels, click Apply
4

NAME & ASSIGN CHANNELS

Open admin → Channels. Rename Blue/Red/Green to anything (e.g. "House", "Latin", "Chill"). Guests see the name on their channel selector. Assign a source to each channel and adjust gain as needed.

🔵 Blue — Live USB DJ Board
🔴 Red — Folder AI DJ (House)
🟢 Green — Playlist Loop
5

PRINT THE QR CODE

The app reads your venue network and generates the correct patron URL automatically. Open admin → Settings → Listener QR Code. Download a high-res PNG or vector SVG and print at any size. Post them around the venue.

  • QR code auto-updates when you move to a new venue or network
  • Print on A4, A3, or 24″ poster — scales without loss
  • Place at entrances, on tables, and at the bar so guests can scan from anywhere
6

GO LIVE

Post the QR codes, start your music, and the dashboard shows every listener connecting in real time. Watch the VU meters, track which channel each guest is on, and restart any stream with one click if something gets stuck.

  • Live Meters — dB levels for all 3 channels, updated every second
  • Listeners Table — device, browser, IP, connection time, channel
  • Restart Audio Engine — one button to recover from any stuck state
Next: WiFi Setup Guide →