17. File Structure on Disk

ESTË Live saves all data in the ~/ESTE/ folder:

~/ESTE/
├── .auth.json                   ← Access control settings + HMAC secret
├── .last_setlist                ← Name of the last used setlist
├── .logs/                       ← Application logs
├── setlists/                    ← Setlist JSON files
│   ├── Default.json
│   ├── Feb 15 Concert.json
│   └── Rehearsal.json
└── songs/                       ← One folder per song
    └── Yesterday/
        ├── Yesterday.json       ← Complete state (mixer + config)
        ├── recordings/          ← Multitrack recordings
        │   └── 2026-02-24_19-30.wav
        ├── backtracks/          ← Backing track audio files
        │   ├── backing_stereo.wav
        │   └── click_guide.mp3
        ├── midi/                ← MIDI files
        │   └── sequence.mid
        └── regions/             ← Region CSV files
            └── regions.csv

Notes:

File/folder names are sanitized: only letters, numbers, dashes, underscores, and spaces allowed
Uploaded audio files are copied into the song folder
Songs are independent from setlists (a song can appear in multiple setlists)
The decoded audio cache is in-memory only and is not saved to disk