This guide explains how to record or archive all of your Video Streaming broadcasts, which can be useful for creating TV replays or reviewing videos recorded by surveillance cameras, for example.

Manage automatic recording of live broadcasts

To activate this option:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Activate the recording of live broadcasts by the toggle switch from the stream dashboard:
   

Once this feature is activated, the stream will be automatically and permanently recorded from the moment it is sent to (or pulled by) the Infomaniak platform.

Be mindful of your FTP space, which could quickly become saturated. If necessary, you also have the option to manually schedule recordings from the scheduling tool.

Operation of automatic recordings

Once this option is activated, an mp4 file will be automatically generated after each broadcast, which will be transferred to the FTP or VOD space configured by you.

Important details:

• A broadcast is defined as the time between connection and disconnection up to the video encoder.
• Recording quality: in the case of a multi-bitrate stream, the maximum source quality will be preserved.
• File size limitation: in the case of continuous broadcasting, you have the option to define the maximum duration of each mp4 file; this option allows you to avoid generating files that are too large and to ensure the recording of your archives to the FTP or VOD space of your choice (and once the duration is reached, the recording is automatically stopped, then sent by FTP and a new recording is started).

Customization of recording names

To allow you to easily identify and classify your archives, the name of the recordings can be customized dynamically using parameters specified between curly braces.

Example:

template_{stream_id}_{date|format:YYYY-MM-dd_hh:mm:ss}_{fragment_id|from:1|prefix:fragment_(|suffix:)}.{extension}

• stream_id = represents the stream identifier in the form of a string.
• date|format: ISO 8601 = date of the recording day.
• time|format: ISO 8601 = time of the recording.
• datetime|format: ISO 8601 = date and time of the recording.
• fragment_id|from:number|prefix:string|suffix:string: = fragment number in case a recording is split with the possibility of prefixing and/or suffixing it.
  • Each fragment will be incremented, "from" allowing to indicate what will be the first reference fragment.
• extension = final extension of the file.

These parameters and their options are optional and their order is completely free. They can be used as many times as desired. If you provide the same option multiple times, only the last one will be taken into account. Any unrecognized option will simply be ignored.

Example 1

Situation: you have two daily schedules, the first starts at 10:00 and the second at 20:05. By configuring the file naming in this way template_{date|format:hh:mm:ss} you will obtain the following file names:

For the day of December 5, 2019:

• The first recording at 10:00 will be called: template-10:00:00.mp4
• The second recording at 20:05 will be called: template-20:05:00.mp4

For the day of December 6, 2019:

• The first recording at 10:00 will be called: template-10:00:00.mp4
  The recording from the previous day with the same name will be overwritten and replaced by this one.
• The second recording at 20:05 will be called: template-20:05:00.mp4
  The recording from the previous day with the same name will be overwritten and replaced by this one.
• etc.

This logic can be particularly useful for having a loop recording system, for example for video surveillance. The user will retrieve the video only if needed and this avoids archiving a potentially infinite number of videos at the risk of saturating the FTP space.

Example 2

Situation: this time you have a perpetual recording, 24/7, with a limitation of the duration of the files set to 360 minutes. By configuring the file naming in this way template_{date|format:YYYY-MM-dd}_{fragment_id|from:1|prefix:fragment_(|suffix:)}.{extension} you will obtain the following file names:

• The first file of the day at 00:00 will be called: template_2019-02-05.mp4
• The second file of the day at 06:00 will be called: template_2019-02-05_fragment(1).mp4
• The third file of the day at 12:00 will be called: template_2019-02-05_fragment(2).mp4
• The fourth file of the day at 18:00 will be called: template_2019-02-05_fragment(3).mp4

By configuring the file naming in this way template_{date|format:YYYY-MM-dd}_{fragment_id|from:0|prefix:fragment_(|suffix:)}.{extension} you will get the following names:

• The first file of the day at 00:00 will be named: template_2019-02-05_fragment(0).mp4
• The second file of the day at 06:00 will be called: template_2019-02-05_fragment(1).mp4
• The third file of the day at 12:00 will be called: template_2019-02-05_fragment(2).mp4
• The fourth file of the day at 18:00 will be called: template_2019-02-05_fragment(3).mp4