DVR export to MP4

DVR feature set in Nimble Streamer provides streams recording and playback. Basic playback is available via a direct HLS or MPEG-DASH link as described in described in this article.

However you may need a "hard copy" of a recording which is just a MP4 file. It can now be exported via Nimble API call. Let's see how you can use it.

First, you need to set up Nimble Streamer to process direct API calls. Open API description page and read "Starting point: enable API access" section regarding the initial setup. You may also want to secure your calls as describe in "Option: Making authorized requests" section.

Second, you need to use this HTTP GET call to obtain the archive:

/manage/dvr/export_mp4/<app>/<stream>[?start=<epoch_time>&end=<epoch_time>]

The content of MP4 result file will be returned in HTTP response body.

The "start" and "end" parameters allow defining the time frame which is going to be exported, defined in seconds of Unix epoch time.

This command will get a portion of your archive:

curl -o archive.mp4 -v "http://127.0.0.1:8082/manage/dvr/export_mp4/live/stream?start=1542708934&end=1542712534" 

This one will download the entire archive: 

curl -o archive.mp4 -v http://127.0.0.1:8082/manage/dvr/export_mp4/live/stream

As mentioned above, the result will be returned as a body of HTTP response.

Also, take a look at JPG DVR thumbnails support and MP4 thumbnails support.

Watch DVR recording and playback in Nimble Streamer tutorial to see DVR export demonstration and also get familiar with the most used features.

If you have any questions on this or other features, let us know.

Related documentation

Nimble Streamer DVR feature set, DVR setup for Nimble Streamer, Live streaming scenarios,