No track loaded

0:00.00
Add audio files, then a config file.
Cues, vamps, repeats and more will appear here.

Config file format

Songs, markers and segues are all set in config files (CSV or JSON), loaded with "Load config" or listed in CONFIG. You can load several; they add together.

Columns (CSV)

Registering songs

With no song rows, each audio file is one song named after the file. To split a long recording, add one song row per song: track = audio file, time = start, to = end (blank = end of file), label = name, next = 1 if it should go straight into the following song. The menu lists songs in the order they are registered in the config (songs from later config files, then CONFIG.songs, follow), with any audio files that have no song rows last, and "following" means the next song in that list (even in another file). Each song shows the markers that fall between its start and end, and its clock and seek bar run from its own start. Without next, playback stops at the song's end and the next song is selected, ready to START; with it, playback carries on seamlessly if the next song starts where this one ends in the same file, otherwise it jumps or switches file. Songs with next show a note under the title, with a 10 second countdown.

Types

track,time,type,label,to,n,dur,next,cut
Act1,0:00,song,Overture,3:42.125,,,1
Act1,3:42.125,song,Opening Number,9:10.5,,,
Act1,3:50,cue,Bar 9
Act1,4:30.25,repeat,,3:50,1
Act1,5:10,vamp,,5:02.5
Act1,5:40,vamp,,5:30,,,,7:15
Act1,6:00,cutoff,,6:30
Act1,6:20,fermata,,6:35
Act1,7:00,caesura,,,,2.5

Labels

Any row can have a label. It appears next to the marker on the seek bar, on its chip, and under the matching button (e.g. under LEAVE VAMP). With no label, a default like "Cue 3" or "Vamp 5:02.50" is used.

Making the config from Audacity labels

  1. In Audacity, add a label track (Tracks › Add New › Label Track). Put the playhead where you want a marker and press Ctrl/Cmd+B, then type the label text. For loops and songs, select a region first so the label spans it.
  2. File › Export › Export Labels… saves a .txt file for each audio file.
  3. Run python3 audacity_to_csv.py "Overture=overture.txt" "Tracks 1-6=tracks.txt" -o config.csv. Each argument is audio name (no extension)=labels file; songs appear in argument order, then by time.
  4. Load the CSV with Load config (or list it in CONFIG.config).

Label text is [type] [name] [options], with no type meaning a cue. Types: song, cue, repeat, vamp, cutoff, fermata, caesura (bar: and section: with a colon also work). Options: > song goes into the next one; x2 repeat count; to=, cut= (a time or next); dur= caesura seconds.

JSON

[ {"track":"Act1","type":"song","label":"Overture","time":"0:00","to":"3:42.125","next":true},
  {"track":"Act1","type":"cue","label":"Bar 9","time":"3:50"} ]

The same fields as the CSV columns. You can also group by track: {"Act1":[ ... ]}.

Using the console

Auto-loading

Edit CONFIG at the top of the script: audio and config are lists of URLs, and songs is a list like {file, name, start, end, next} (same as song rows). A loading screen shows until everything is in. The files must be reachable from where this page is hosted.