Recording Settings

The <RecordingSettings> block configures recording of live streams to disk. Storm supports multiple output formats and provides controls for file splitting, storage management, and automatic recording.

Available in: mono, origin

Sample Configuration

RecordingSettings block

xml

<RecordingSettings enabled="true">
    <FileFormat>fMP4</FileFormat>
    <SavePath>/var/recordings</SavePath>
    <MaxFileSize>10</MaxFileSize>
    <MaxFileDuration>10</MaxFileDuration>
    <CacheSize>1</CacheSize>
    <MaxStorageSize>1500</MaxStorageSize>
    <RemoveOldFiles>true</RemoveOldFiles>
    <AutoRecording>true</AutoRecording>
</RecordingSettings>

Parameters

Parameter	Description	Default
`RecordingSettings:enabled`	Enables or disables recording for this application.	`false`
`<FileFormat>`	Output file format. Available formats: `fMP4`, `FLV`, `MKV`.	—
`<SavePath>`	Directory path where recorded files will be saved.	—
`<MaxFileSize>`	Maximum file size in MB. When reached, the recording is split into a new file. Leave empty or set to `0` for no limit.	`0`
`<MaxFileDuration>`	Maximum file duration in seconds. When reached, the recording is split into a new file. Leave empty or set to `0` for no limit.	`0`
`<CacheSize>`	Amount of stream data (in MB) to buffer in memory before flushing to disk.	`1`
`<MaxStorageSize>`	Maximum total size (in MB) of all recorded files in the `<SavePath>` directory. When reached, recording stops or old files are removed depending on `<RemoveOldFiles>`. Leave empty or set to `0` for no limit.	`0`
`<RemoveOldFiles>`	If set to `true` and combined with `<MaxStorageSize>`, the oldest recorded files will be automatically removed to make space for new recordings.	`false`
`<AutoRecording>`	If set to `true`, every stream is recorded automatically as soon as it is published.	`false`

Note

When <AutoRecording> is disabled, recording can still be triggered on a per-stream basis via the REST API or the Control Panel.

Environment Variables

All parameters support environment variables using the ${EV:VARIABLE_NAME} syntax. Fields locked by environment variables cannot be modified via the REST API.

Support Needed?

If you have any questions or need assistance, please create a support ticket and our team will help you.