Sessions and Tracks

Sessions and the Session Graph

Every edit creates a session node, a snapshot of the session. Nodes link to their parent in a directed acyclic graph (DAG), so nothing is destructive: your original audio files are never modified and you can return to any earlier state.

• Graph view — the Graph tab, beside Timeline and Transcript, draws all session nodes with their label, the tool that made them and their age.
• Preview a version — click a node in the graph to render that version's mix and play it. The node gets a dashed outline and your place in the history does not move: the next edit or undo starts from where you were.
• Revert to any node — right-click a node in the graph and choose "Set as head" to jump back to that state. Undo brings you back.
• Fork — branch from any node to try another direction.
• Undo and redo — Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z retrace the steps you took, the agent's edits included. The path is saved with the project, so it survives a restart.
• Compact history — ask this project is huge — reclaim some disk and the agent reports what it would remove, then, if you confirm, deletes old undo steps for good, with the audio the project made for them. A file you loaded is never deleted. The most recent steps stay, so ordinary undo keeps working.
• One writer per project folder — opening a project is refused while a batch run is writing its own project into that folder, and while the folder was replaced at the same path (restored from a backup, or trashed and made again) and the assistant is still working in the old one. Wait for the turn to end, then open it again. A batch run is likewise refused, and starts nothing, if one of the projects it would write is open.

Tracks

A session has one or more tracks, each a sequence of clips. A clip describes a region of a source file on disk, not a copy of it.

• Load audio — drag a file onto the timeline, click “Open Audio”, or type load /path/to/file.mp3. Formats: WAV, MP3, FLAC and Ogg Vorbis.
• Multi-track sessions — load several files or ask: add an empty track called drums.
• Lane controls — each track's lane has its own gain slider, pan slider, mute and solo buttons, so you can mix by hand. Double-click a pan slider to centre it. A mute silences a track without removing it; a solo plays only the soloed tracks. One drag or click is one history step, and a control you have just set stays put until the session confirms it.