Rendering, Recipes and Batch

Render the full session to WAV, FLAC or MP3. FLAC is lossless — identical audio, roughly half the size. MP3 is lossy but plays anywhere; bitrate defaults to 192 kbps. Takes title, artist, album, year and comment, written as Vorbis comments on FLAC and ID3v2 on MP3, and can carry the session's markers through as chapters.

Example prompt: export to /Users/me/Desktop/final.wav

Returns: path, duration_sec, peak_dbfs, sample_rate, tagged, chapters, warnings (only when something was left out)

A stored effect the renderer cannot run in a chain yet (a project from an older build can hold one) is left out and the render still succeeds; warnings names each one, and a line in summary says so. Tags are applied after encoding — FLAC blocks are rewritten in place and an ID3 tag is a prefix — so tagging never touches a sample. WAV has no standard tag container worth using and refuses metadata rather than dropping it silently. A path that is audio the project reads is refused, because the render would replace it: a file you loaded (even a lossy one the project plays a copy of), or any file an earlier step of the history plays, however the path is spelt. Choose another path; an earlier export, or a path nothing reads, is written as before.

Render a preview WAV, cached by node id — re-previewing the same session state reuses the render instead of redoing it.

Example prompt: (used internally for playback)

Returns: path, warnings (only when something was left out)

A stored effect the renderer cannot run in a chain yet is left out and listed in warnings, on a cached preview too.

Export selected tracks as individual WAV files to a directory.

Example prompt: export tracks 1 and 2 as separate files

Returns: list of exported paths, warnings (only when something was left out)

Write the session's edit chain — every tool and its parameters, in order — to a JSON file with no audio in it. Reviewable by eye before anyone runs it, and replayable against the same source or a different one.

Example prompt: export this edit chain so I can reuse it

Returns: path, steps, blockers

Steps that cannot be replayed (ML models) are marked in the file rather than silently dropped.

Replay an exported edit chain. Every step is checked before any of them runs, so a recipe that cannot keep its promise is refused whole — naming the step — rather than half-applied. Takes an optional different source, and a dry run that reports the plan without touching the session.

Example prompt: run my podcast chain on this recording

Returns: steps_applied, head, notes

Replaying against the same audio reproduces the same bytes; the derived files are named by their own sample rate, channel count and samples, so a drifted rebuild is detected rather than substituted. Names from projects saved by earlier builds are still recognised when a project's history is rebuilt.

Run an exported edit chain across every audio file in a folder. Each file becomes its own project with its own history — a batch is not one giant session. Every file is attempted even if an earlier one fails, and the report says what succeeded, what refused, and why.

Example prompt: run my podcast chain over every file in this folder

Returns: files, succeeded, refused, per-file results

A chain that cannot be replayed is refused once, up front — that is a property of the chain, not of the twelve files. So is an output folder that would put a file's project where a project is open right now: each file's project goes in <output_dir>/<file name without its extension>, and a batch never writes into a project you have open, so choose another output_dir. So is a render that would land on one of the input files: output_dir defaults to the input folder, so with render_format set to the inputs' own format (wav for .wav files) each render would be written over its input. Your originals are never written over; choose another output_dir. Nothing is started in either case.