Stand behind the decks of a hangar show. The light follows what you play.
A full-width festival stage in an industrial hangar, 182 moving heads, haze and a crowd of 3,000, lit live from your music.
Download · Get started · Connect music · Keys · MIT license
SV is for someone who DJs at home and wants the real thing around them: one hall, one stage over the full width, one DJ booth with two club players and a four-channel mixer in the familiar club layout, flightcase edging and routed cables. Play from rekordbox or any music on your computer, and a lighting designer runs the show: a mood for every genre, one palette per track, looks held for a phrase, a build-up that lowers the trusses, and a drop that opens the whole rig.
From 0.50 SV is built with Godot 4.7 and runs on Windows, macOS and Linux. The browser version lives on in the history of this repository, up to v0.40.1.
 |
 |
| Through the DJ's eyes The decks show what rekordbox plays. |
The drop The whole rig opens; blinders light the crowd. |
 |
 |
| First start Choose your source and see that it works. |
Escape A menu; the show goes on. |
Actual screenshots of 0.53 at Ultra.
- Download the latest package for Windows, macOS or Linux from Releases.
- Extract it and open SV:
SV.exeon Windows,Stage Visualizer.appon macOS, orSV.x86_64on Linux. If your computer blocks the first launch, see opening a downloaded build. - Choose your music source, check that it works, set the delay and choose your flashing-light preference.
To run from source, install Godot 4.7.2 (standard version), clone this repository and run:
./start.shOr open the folder in Godot and press Play.
To make an app for Windows, macOS or Linux, see builds.
- System audio: whatever plays on your computer. On macOS route it through BlackHole, see macOS.
- rekordbox: through rkbx_link, OSC on port 4460. SV then knows the beats, the phrases and the decks, sees a drop coming and lands it on the first beat of the Chorus. rekordbox can run on this computer or another one on your network: see rekordbox.
- Both: rekordbox for the timing, the sound for the energy.
| Key | What |
|---|---|
| Esc | Pause menu (the show goes on) |
| ? or F1 | All keys |
| B | Blackout on / off |
| D | Light desk: group switches, percentage faders and haze (0–200%) |
| W | Washes on / off |
| Space | Strobe while held |
| N | Blinders while held |
| L | Next look |
| G | Next genre (Shift: back) |
| 1–5 | Camera: the DJ's eyes, over the shoulder, in the crowd, front of house, stage side |
| T | The one is here (tap on the first beat) |
| [ ] | Lights earlier / later |
| S | Gentle strobes |
| I | Info screen |
| H | Hide everything |
| F | Full screen |
| Q | Quality |
| P | Settings |
A DJ controller can work the same buttons: Pause menu → DJ controller → Learn, then press a pad.
- Hall: an industrial hangar of 44 × 76 m, 15 m high: steel girders and columns, cladding, exits, haze, a concrete floor that shines when wet, and a crowd of 3,000 that moves to the music.
- Rig: five hall trusses in a V on chain hoists, a truss at the back, towers behind the DJ, delay towers and side towers, spots and LED bars on the stage roof: beams, spots with gobos, washes, strobe battens and blinders.
- Show: SV's lighting director, with 36 genres from Beatport, 35 looks for the heads, 15 truss formations and 9 looks for the stage row. It plays in passages of 16 or 32 bars: one group leads, the others support or hold (how it works).
- Graphics: Low to Ultra, or Auto, measured on your own computer.
./start.sh -- --record
./start.sh -- --replay=local/sessions/NAME.jsonlA session keeps the music's values for every frame and, when it can, a WAV copy. See sessions and automatic checks.
MIT. Atkinson Hyperlegible is under the SIL Open Font License.