Music
The festival comes without music. You add your own songs. Each server is responsible for the music it uses: make sure you have the right to play it.
Two ways to add a song
Way 1: a file in the music/ folder (recommended)
This is the safest way. The file never disappears.
-
Convert your song to .ogg (free tools: Audacity, or any online converter).
.mp3also works, but.oggis the safest. -
Copy the file into
vault-festival/music/. Example:music/my_set.ogg. -
Open
config/audio.luaand add it to the list:Config.Tracks = { { name = 'My set', file = 'my_set.ogg' }, } -
Restart the server so players download the new file.
Way 2: a direct link
- You need a direct link to the audio file. It must start with
http://orhttps://and end in the file (for examplehttps://example.com/set.ogg). 300 characters at most. - Add it in one of these places:
- in the admin panel, section Music, with Add (no restart needed), or
- in
config/audio.lua:{ name = 'Remote set', url = 'https://example.com/set.ogg' }, or - typed in the URL box of the console (just to play it once).
What does NOT work: YouTube, Spotify, SoundCloud pages, Google Drive “share” pages, or any page that is not the audio file itself.
Warning: links that expire. Many links (Discord attachments, temporary file hosts, some cloud drives) stop working after hours or days. The song then plays silence and cannot be analysed. Download the file and put it in
music/instead.
Playing a song
- Open the console (
/festival console). - In Music, pick a song in Track (or type a link in URL).
- Press ▶ in the top bar.
Every player near the festival hears it, in sync, louder as they get closer. ■ stops it. Click on the timeline to jump to another point.
The admin panel also has a Stop music button.
The automatic light show
A song can play without anything else, but in Auto mode the lights stay off. To get lights, analyse the song once.
Analysing a song
- Pick the song in the console.
- Press Analyse.
- Wait. The console downloads the song and listens to it. Your screen freezes for a few seconds: this is normal.
- When it says “Show saved”, it is done.
The console has found the tempo, the beats and the parts of the song (intro, break, build, drop, outro), and it has written a complete light show: scene and colour changes, strobes, blinders, pyro and effects at the big moments.
- Analysis is done once per song. The server keeps the show, also after a restart.
- Analysis runs on the computer of the operator who presses the button.
- It is automatic and approximate. Songs with a clear beat (house, techno, EDM) work best. Very calm or irregular songs can come out less exact.
- If you change the link or rename the file, the song counts as new: analyse it again.
- To analyse a link, the website that hosts it must allow it (this is called CORS). If not, it plays but cannot be analysed: put the file in
music/instead. - Very long sets (more than an hour) may be too big to analyse.
Changing the show
- Regenerate (on the timeline): creates a new version of the show for the same song, without analysing again. Your manual changes are lost.
- Right-click a cue on the timeline: gives it the scene and palette you have selected. Saved at once.
- Hybrid mode: the show keeps running and you play on top of it. Whatever scene or palette you choose wins while it is set. Use Live mode to control everything yourself.
Remember: in Auto and Hybrid modes, the show fires pyro even when pyro is not armed. Use Live mode if you want no pyro.
Where are shows saved?
In the shows/ folder of the resource, on the server. The folder must exist and the server must be able to write in it. Keep a copy of it when you update the resource.
Managing the list from the admin panel
In the Music section of the admin panel you can:
- Add a song (name + link).
- Rename a song.
- Remove a song (and, if you want, its analysis too).
- Delete analysis to analyse a song again from zero.
- See which songs are Analysed or Not analysed.
Songs marked From config come from config/audio.lua. Change or remove them in that file, not in the panel.