Recording output

Recording writes durable, playable sessions under output.root/vod. The stable session entry point remains valid while media grows and after the session closes.

retention defaults to 0s, which disables automatic deletion. Positive retention removes only closed sessions that satisfy publication and safety gates.

"recording": {
  "enabled": true,
  "chunkDuration": "6s",
  "retention": "0s",
  "publish": true
}

This example opts recording into the shared output.s3 destination. Omit publish or set it to false for local-only recording.

The stable recording entry path identifies a durable VOD tree; the Server media listener does not serve /vod/. Expose that tree through the deployment's own trusted HTTP serving boundary, or publish it to object storage. Treat webhook recordingUrl values as opaque paths rather than rebuilding them from admission timestamps.

Each session has one wall-clock presentation anchor. Renditions registered before the first multivariant playlist form the initial cohort. A late rendition starting after the anchor receives EXT-X-GAP entries covering the preceding span; GAP and real chunks share one ordered rendition sequence space. Publication commits the chunk file before its Catalog/media-playlist entry, then updates multivariant membership.

Use the shared output settings with this module. The complete field reference covers every accepted option; the maximal composition shows how modules fit together.