edytlab
Audio Tools Reference

Rendering and Export

Export the session, or a range of it, to WAV, AIFF, FLAC, MP3 or OGG, render previews, and write tracks and transcripts to files.

On this page4 tools
render_final

Render the full session, or part of it, to WAV, AIFF, FLAC, MP3 or OGG. Give range as [start, end] in session seconds to export part of the session; markers outside it are left out of the chapters, and the ones inside count from the export's start. AIFF is uncompressed. FLAC is lossless, roughly half the size. MP3 is lossy but plays anywhere (192 kbps default). OGG is lossy Opus, smaller than MP3 (128 kbps default). Takes title, artist, album, year and comment, written as Vorbis comments on FLAC and OGG 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, frames_written, sample_rate, channels, peak_dbfs, format, bitrate_kbps (mp3 and ogg), range (when asked), tagged and chapters (when tagged), 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 and AIFF have no standard tag container worth using and refuse 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_preview

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_multiple

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)

export_transcript

Write the stored transcript to out_path (relative to the project, or absolute) as srt (default), vtt or txt. A new cue starts at sentence-ending punctuation and at a pause of pause_sec (default 0.75); max_cue_sec (default 6) and max_chars_per_line (1 to 200, default 42) bound a cue. Captions have at most two lines, except that one long stored word keeps its recorded times. UTF-8 with LF line endings.

Example prompt: export the transcript to captions.srt

Returns: out_path, format, word_count, cue_count, byte_count, time_basis, time_note, source, summary

Run transcribe first. Times are session seconds for a track and follow edits that move, cut or stretch it; align_to_beat leaves them stale (time_note says so). Written atomically; refuses project audio and the project's .audiograph folder. SRT keeps raw text, WebVTT escapes &, < and >. Changes no audio or history.