Output Audio File

4 VersionsOutput

Encodes an AudioFrame stream into a chosen container and writes it as a set of rolling files on disk, starting a new segment on a fixed time interval and keeping only the most recent ones, so a generator or recorder leaves a bounded audio archive.

How it fits

Typical backends

Synthesised speech from generate_speech_kokoro is captured to rolling files for later review.

Audio read from a file source is re-encoded and written back out as bounded rolling segments.

Caveats

I/O contractEncoding is briefly interrupted at each segment boundary, so expect a small gap between rolled files; a consumer splicing segments should overlap its reads.
Parameter interactionA max_files of zero keeps every segment forever; set a positive cap or watch disk usage. Both it and file_size_seconds can be tuned while running and take effect from the next segment.
Parameter interactionbit_rate only applies to lossy codecs; for PCM containers such as wav it is ignored, and the codec is derived from format, so an unusual container the build cannot encode aborts at startup.
CostAt very high sample rates or channel counts, disk throughput can become the bottleneck.

Versions

a1433828default
Automated release
8/1/2026