Skip to main content

record

The record command is used to create and manage video recordings. For more information, see Configuring Recording Outputs and Managing Recordings.

Synopsis

record create stream=id
record ID start
record ID stop
record ID close
record ID get
record list
record delete [filename, all]
record copy filename usb
record move filename usb

Actions

ActionDescription

create

Creates a recording for a stream. A series of one or more parameter=value pairs can be specified at once. See Parameters below.

start

Starts recording a stream.

stop

Stops recording a stream.

close

Closes a recording of a stream

get

Displays information on the recording. You can specify configuration, stats, or all recording information.

Tip

To display a summary of all the streams in a table format, you can use record all get table.

list

Lists the available recordings on the system.

delete

Deletes either the recording specified by <filename> or all recordings.

copy

Copies the recording specified by <filename> to a USB device

move

Moves the recording specified by <filename> to a USB device and deletes the recording from the encoder.

Parameters

ParameterDefaultDescription/Values

name


The identifying prefix for recorded files. If not specified, the stream name or ID will be used.

format

ts 

The file format for recordings, either:

  • mp4
  • ts

limit


The recording duration or size, ex 1h30m, 500M

segment


Enables segmented recording by specifying the duration or size of each segment.

recycle

off

When segmented recording is enabled and the recording is limited in space or time, this enables the overwriting of older segments when that limit is reached.

subtitles

off

When recording in mp4 format, this enables the generation of SubRip files to save any closed caption present in the stream being recorded.

start

off

Starts recording directly at recording creation time. The IDs of recordings always match the ID of the stream associated with it.

export

off

Exports recordings and segments automatically when they are complete.

destination


The destination of recording transfers when export is enabled.

  • id or name

delete

off

Deletes recordings when they are successfully transferred. The IDs of recordings always match the ID of the associated stream.

Examples

# record all get

Records information for the recording, for example:

Recording ID  : 1
Recording Name : "continuous"
Configuration:
Format : TS
Recording Limit : 5d5h
Segmented : On
Segment Limit : 10m
Segment Recycling : Off
Auto-Export : Off
# record list

Lists the available recordings, for example:

Recordings (in /mnt/storage1/recordings/):
Test-2015-04-10-14h11m09s.mp4 (1920x1080, 36s, 25.66MB, root)
REC-2015-04-12-21h11m06s.mp4 (1920x1080p29, 23s, 16.55MB, root)
TEST-2015-04-12-23h20m20s.mp4 (1280x720p60, 2h41m12s, 43.50MB, root)
TEST-2015-04-13-10h10m15s.mp4 (1280x720p60, 27m36s, 35.70MB, root)
TEST-2015-04-13-10h38m56s.mp4 (1280x720p, 1m, 35.59MB, root)
TEST-2015-04-14-11h52m05s.mp4 (1280x720p, 1m, 41.51MB, root)
TEST-2015-04-14-13h50m52s.ts (1280x720p60, 3h34m49s, 44.77MB, root)
TEST-2015-04-14-17h26m45s.ts (1920x1080i29, 1m, 44.24MB, root)
continuous-2015-05-19-12h16m12s (Segmented, 1920x1080p30, 20h34m49s,
222.34GB, root)
9 recordings are available.
222.81GB (100%) of 222.81GB recording disk storage space used.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.