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

Manage automatic recording of live broadcasts

To enable 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 relevant product.
3. Activate live recording using the toggle switch from the stream dashboard:
   

Once this feature is activated, the stream will be automatically and perpetually 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 needed, you also have the option to manually schedule recordings using the scheduling tool.

How automatic recordings work

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 to the video encoder.
• Quality of recordings: in the case of a multi-bitrate stream, the maximum source quality will be preserved.
• File size limitation: In case of continuous streaming, you have the possibility 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 launched).

Customization of recording names

To allow you to easily identify and organize your archives, the recording names can be dynamically customized using parameters specified within 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 as 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 to prefix and/or suffix it.
  • Each fragment will be incremented, "from" indicating which will be the first reference fragment.
• extension = final file extension.

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 considered. 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 get the following file names:

For the day of December 5, 2019:

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

For the day of December 6, 2019:

• The first recording at 10:00 will be named: 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 named: 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 file duration limit 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 get 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 6:00 AM will be named: 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 called: template_2019-02-05_fragment(0).mp4
• The second file of the day at 6:00 AM will be named: 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