Top

Articles in this section

Encoding formats

Avatar
Andrey B.
  • Updated

All CPU codecs from the following table is the FFMpeg based video codecs. GPU codecs is a custom implementation of Medialooks team.

 

MPEG Program Stream

Configuration Parameter: mpeg

Extensions: mpg,mpeg

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as a value.
raw_audio string   Capture RAW audio. Set target save path as a value.
ignore_pts string   Ignore video sample times. Possible values: true, false.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
muxrate int 0 Set user-defined mux rate expressed as a number of bits/s. If not specied the automatically computed mux rate is employed. Default value is 0.
preload int 500000 Initial demux-decode delay in microseconds.

Video codecs

  • MPEG-1 Video
  • MPEG-2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • MPEG-4 part 2 Video
  • Direct stream copy
  • No Video

Audio codecs

  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

MPEG Transport Stream

Configuration Parameter: mpegts

Extensions: ts,m2t,m2ts,mts

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
embed_scte35 bool false Enable embedding SCTE-35 triggers into MPEG transport stream.
raw_video string   Capture RAW video. Set target save path as a value.
raw_audio string   Capture RAW audio. Set target save path as a value.
ignore_pts string   Ignore video sample times. Possible values: true, false.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
mpegts_transport_stream_id int 1 Set the transport_stream_id field. This identifies a transponder in DVB. Default is 0x0001.
mpegts_original_network_id int 65281 Set the original_network_id. This is unique identifier of a network in DVB. Its main use is in the unique identification of a service through the path Original_Network_ID, Transport_Stream_ID.
mpegts_service_id int 1 Set the ‘service_id’, also known as program in DVB. Default is 0x0001.
mpegts_service_type option digital_tv Set service_type field.
  • digital_tv - Digital Television.
  • digital_radio - Digital Radio.
  • teletext - Teletext.
  • advanced_codec_digital_radio - Advanced Codec Digital Radio.
  • mpeg2_digital_hdtv - MPEG2 Digital HDTV.
  • advanced_codec_digital_sdtv - Advanced Codec Digital SDTV.
  • advanced_codec_digital_hdtv - Advanced Codec Digital HDTV.
  • hevc_digital_hdtv - HEVC Digital Television Service.
mpegts_pmt_start_pid int 4096 Set the first PID for PMTs. Default is 0x1000, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the PMT PID is fixed 0x0100.
mpegts_start_pid int 256 Set the first PID for elementary streams. Default is 0x0100, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the elementary stream PIDs are fixed.
mpegts_m2ts_mode     Enable m2ts mode if set to 1. Default value is -1 which disables m2ts mode.
muxrate int 1 Set a constant muxrate (in bits/s). Default is VBR.
pes_payload_size int 2930 Minimum PES packet payload in bytes
mpegts_flags flags   MPEG-TS muxing flags
  • resend_headers - Reemit PAT/PMT before writing the next packet
  • latm - Use LATM packetization for AAC
  • pat_pmt_at_frames - Reemit PAT and PMT at each video frame
  • system_b - Conform to System B (DVB) instead of System A (ATSC)
  • initial_discontinuity - Mark initial packets as discontinuous
resend_headers int 0 Reemit PAT/PMT before writing the next packet.
mpegts_copyts     Preserve original timestamps, if value is set to 1. Default value is -1, which results in shifting timestamps so that they start from 0.
tables_version int 0 Set PAT, PMT, SDT and NIT version (default 0, valid values are from 0 to 31, inclusively). This option allows updating stream structure so that standard consumer may detect the change.
omit_video_pes_length     Omit the PES packet length for video packets.
pcr_period int 20 Override the default PCR retransmission time in milliseconds. Default is -1 which means that the PCR interval will be determined automatically: 20 ms is used for CBR streams, the highest multiple of the frame duration which is less than 100 ms is used for VBR streams.
pat_period double 2147483647.000000 PAT/PMT retransmission time limit in seconds.
sdt_period double 2147483647.000000 SDT retransmission time limit in seconds.

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Direct stream copy
  • No Video

Audio codecs

  • MP2 (MPEG audio layer 2)
  • AAC (Advanced Audio Coding)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

MPEG-DASH Streaming

Configuration Parameter: dash

Extensions: mpd

Additional attributes

Name Type Default Description
adaptation_sets string   Adaptation sets. Syntax: id=0,streams=0,1,2 id=1,streams=3,4 and so on.
window_size int 0 Number of segments kept in the manifest.
extra_window_size int 5 Number of segments kept outside of the manifest before removing from disk.
min_seg_duration int 5000000 Minimum segment duration (in microseconds) (will be deprecated).
seg_duration     Segment duration (in seconds, fractional value can be set).
frag_duration     Fragment duration (in seconds, fractional value can be set).
frag_type option none

Set the type of interval for fragmentation.

Possible values:

  • ‘auto’ - Set one fragment per segment
  • ‘every_frame’ - Fragment at every frame
  • ‘duration’ - Fragment at specific time intervals
  • ‘pframes’ - Fragment at keyframes and following P-Frame reordering (Video only, experimental)
remove_at_exit bool false Enable or disable removal of all segments when finished. This is disabled by default.
use_template bool true Enable or disable use of SegmentTemplate instead of SegmentList in the manifest. This is enabled by default.
use_timeline bool true Enable or disable use of SegmentTimeline within the SegmentTemplate manifest section. This is enabled by default.
single_file bool false Enable or disable storing all segments in one file, accessed using byte ranges. The name of the single file can be specified with the single_file_name option, if not specified assume the basename of the manifest file with the output format extension. This is disabled by default.
single_file_name string   DASH-templated name to use for the manifest baseURL element. Imply that the single_file option is set to true. In the template, $ext$ is replaced with the file name extension specific for the segment format.
init_seg_name string   DASH-templated name to use for the initialization segment. Default is init-stream$RepresentationID$.$ext$. $ext$ is replaced with the file name extension specific for the segment format.
media_seg_name string   DASH-templated name to use for the media segments. Default is chunk-stream$RepresentationID$-$Number%05d$.$ext$. $ext$ is replaced with the file name extension specific for the segment format.
utc_timing_url string   URL of the page that will return the UTC timestamp in ISO format, for example https://time.akamai.com/?iso
method string   Use the given HTTP method to create output files. Generally set to PUT or POST.
http_user_agent string   Override User-Agent field in HTTP header. Applicable only for HTTP output.
http_persistent     Use persistent HTTP connections. Applicable only for HTTP output.
hls_playlist     Generate HLS playlist files. The master playlist is generated with filename specified by the hls_master_name option. One media playlist file is generated for each stream with filenames media_0.m3u8, media_1.m3u8, etc.
streaming bool false Enable or disable chunk streaming mode of output. In chunk streaming mode, each frame will be a moof fragment which forms a chunk. This is disabled by default.
timeout     Set timeout for socket I/O operations expressed in seconds (fractional value can be set). Applicable only for HTTP output.
index_correction bool false Enable or disable segment index correction logic. Applicable only when use_template is enabled and use_timeline is disabled. This is disabled by default. When enabled, the logic monitors the flow of segment indexes. If a streams’s segment index value is not at the expected real time position, then the logic corrects that index value. Typically this logic is needed in live streaming use cases. The network bandwidth fluctuations are common during long run streaming. Each fluctuation can cause the segment indexes fall behind the expected real time position.
format_options     Set container format (mp4/webm) options using a :-separated list of key=value parameters. Values containing: special characters must be escaped.
global_sidx     Write global SIDX atom. Applicable only for single file, mp4 output, non-streaming mode.
dash_segment_type option auto

Set DASH segment files type.

Possible values:

  • ‘auto’ - The dash segment files format will be selected based on the stream codec. This is the default mode.
  • ‘mp4’ - The dash segment files will be in ISOBMFF/MP4 format
  • ‘webm’ - The dash segment files will be in WebM format
segment_type string  

Possible values:

  • auto - Select segment file format based on codec
  • mp4 - Make segment file in ISOBMFF format
  • webm - Make segment file in WebM format
ignore_io_errors bool false

Ignore IO errors during open and write. Useful for long-duration runs with network output. This is disabled by default.
lhls    

Enable Low-latency HLS(Experimental). Adds #EXT-X-PREFETCH tag with current segment's URI. This is an experimental feature.
ldash bool false

Enable Low-latency Dash by constraining the presence and values of some elements. This is disabled by default.
master_m3u8_publish_rate int 0

Publish master playlist repeatedly every after specified number of segment intervals.
write_prft    

Write Producer Reference Time elements on supported streams. This also enables writing prft boxes in the underlying muxer. Applicable only when the utc_url option is enabled. It is set to auto by default, in which case the muxer will attempt to enable it only in modes that require it.
mpd_profile flag dash

Set one or more MPD manifest profiles.

Possible values:

  • ‘dash’ - MPEG-DASH ISO Base media file format live profile
  • ‘dvb_dash’ - DVB-DASH profile

Default value is dash.
http_opts    

Specify a list of :-separated key=value options to pass to the underlying HTTP protocol. Applicable only for HTTP output.
target_latency    

Set an intended target latency in seconds for serving (fractional value can be set). Applicable only when the streaming and write_prft options are enabled. This is an informative fields clients can use to measure the latency of the service.
min_playback_rate double 1/1

Set the minimum playback rate indicated as appropriate for the purposes of automatically adjusting playback latency and buffer occupancy during normal playback by clients.
max_playback_rate double 1/1

Set the maximum playback rate indicated as appropriate for the purposes of automatically adjusting playback latency and buffer occupancy during normal playback by clients.

Video codecs

  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder

Audio codecs

  • AAC (Advanced Audio Coding)
  • MP3 Lame (MPEG audio layer 3)

MP4 (MPEG-4 Part 14)

Configuration Parameter: mp4

Extensions: mp4

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
ignore_pts string   Ignore video sample times. Possible values: true, false.
movflags flags   MOV muxer flags
  • rtphint - Add RTP hint tracks
  • empty_moov - Make the initial moov atom empty
  • frag_keyframe - Fragment at video keyframes
  • frag_every_frame - Fragment at every frame
  • separate_moof - Write separate moof/mdat atoms for each track
  • frag_custom - Flush fragments on caller requests
  • isml - Create a live smooth streaming feed (for pushing to a publishing point)
  • faststart - Run a second pass to put the index (moov atom) at the beginning of the file
  • omit_tfhd_offset - Omit the base data offset in tfhd atoms
  • disable_chpl - Disable Nero chapter atom
  • default_base_moof - Set the default-base-is-moof flag in tfhd atoms
  • dash - Write DASH compatible fragmented MP4
  • frag_discont - Signal that the next fragment is discontinuous from earlier ones
  • delay_moov - Delay writing the initial moov until the first fragment is cut, or until the first fragment flush
  • global_sidx - Write a global sidx index at the start of the file
  • write_colr - Write colr atom (Experimental, may be renamed or changed, do not use from scripts)
  • write_gama - Write deprecated gama atom
  • use_metadata_tags - Use mdta atom for metadata.
  • skip_trailer - Skip writing the mfra/tfra/mfro trailer for fragmented files
  • negative_cts_offsets - Use negative CTS offsets (reducing the need for edit lists)
moov_size int 0 Reserves space for the moov atom at the beginning of the file instead of placing the moov atom at the end. If the space reserved is insufficient, muxing will fail.
rtpflags flags   RTP muxer flags
  • latm - Use MP4A-LATM packetization instead of MPEG4-GENERIC for AAC
  • rfc2190 - Use RFC 2190 packetization instead of RFC 4629 for H.263
  • skip_rtcp - Don't send RTCP sender reports
  • h264_mode0 - Use mode 0 for H.264 in RTP
  • send_bye - Send RTCP BYE packets when finishing
skip_iods     Skip writing iods atom.
iods_audio_profile int -1 Specify iods number for the audio profile atom (from -1 to 255), default is -1.
iods_video_profile int -1 Specify iods number for the video profile atom (from -1 to 255), default is -1.
frag_duration int 0 Create fragments that are duration microseconds long.
min_frag_duration int 0 Do not create fragments that are shorter than duration microseconds long.
frag_size int 0 Create fragments that contain up to size bytes of payload data.
ism_lookahead int 0 Specify number of lookahead entries for ISM files (from 0 to 255), default is 0.
video_track_timescale int 0 Set the timescale used for video tracks. Range is 0 to INT_MAX. If set to 0, the timescale is automatically set based on the native stream time base. Default is 0.
brand string   Override major brand.
use_editlist     Use edit list (default value is auto).
fragment_index int 1 Fragment number of the next fragment.
mov_gamma double 0.000000 Specify gamma value for gama atom (as a decimal number from 0 to 10), default is 0.0, must be set together with + movflags.
frag_interleave int 0 Interleave samples within fragments (max number of consecutive samples, lower is tighter interleaving, but with more overhead).
encryption_scheme string   configure the encryption scheme, allowed values are ‘none’, and ‘cenc-aes-ctr’.
encryption_key     Set the media encryption key in hexadecimal format.
encryption_kid     Set the media encryption key identifier in hexadecimal format.
use_stream_ids_as_track_ids     Use stream ids as track ids.
write_tmcd     Specify on to force writing a timecode track, off to disable it and auto to write a timecode track only for mov and mp4 output (default).
display_rotation
 double   Set video rotation metadata. Rotation is a decimal number specifying the amount in degree by which the video should be rotated counter-clockwise before being displayed.

Video codecs

  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • NVIDIA NVEnc AV1 Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • MPEG-2 Video
  • MJPEG (Motion JPEG)
  • MPEG-1 Video
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Ogg Vorbis
  • Direct stream copy
  • No Audio

MOV (QuickTime File Format)

Configuration Parameter: mov

Extensions: mov

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00"
ignore_pts string   Ignore video sample times. Possible values: true, false
movflags flags   MOV muxer flags
  • rtphint - Add RTP hint tracks
  • empty_moov - Make the initial moov atom empty
  • frag_keyframe - Fragment at video keyframes
  • frag_every_frame - Fragment at every frame
  • separate_moof - Write separate moof/mdat atoms for each track
  • frag_custom - Flush fragments on caller requests
  • isml - Create a live smooth streaming feed (for pushing to a publishing point)
  • faststart - Run a second pass to put the index (moov atom) at the beginning of the file
  • omit_tfhd_offset - Omit the base data offset in tfhd atoms
  • disable_chpl - Disable Nero chapter atom
  • default_base_moof - Set the default-base-is-moof flag in tfhd atoms
  • dash - Write DASH compatible fragmented MP4
  • frag_discont - Signal that the next fragment is discontinuous from earlier ones
  • delay_moov - Delay writing the initial moov until the first fragment is cut, or until the first fragment flush
  • global_sidx - Write a global sidx index at the start of the file
  • write_colr - Write colr atom (Experimental, may be renamed or changed, do not use from scripts)
  • write_gama - Write deprecated gama atom
  • use_metadata_tags - Use mdta atom for metadata.
  • skip_trailer - Skip writing the mfra/tfra/mfro trailer for fragmented files
  • negative_cts_offsets - Use negative CTS offsets (reducing the need for edit lists)
moov_size int 0 Reserves space for the moov atom at the beginning of the file instead of placing the moov atom at the end. If the space reserved is insufficient, muxing will fail.
rtpflags flags   RTP muxer flags
  • latm - Use MP4A-LATM packetization instead of MPEG4-GENERIC for AAC
  • rfc2190 - Use RFC 2190 packetization instead of RFC 4629 for H.263
  • skip_rtcp - Don't send RTCP sender reports
  • h264_mode0 - Use mode 0 for H.264 in RTP
  • send_bye - Send RTCP BYE packets when finishing
skip_iods     Skip writing iods atom.
iods_audio_profile int -1 Specify iods number for the audio profile atom (from -1 to 255), default is -1.
iods_video_profile int -1 Specify iods number for the video profile atom (from -1 to 255), default is -1.
frag_duration int 0 Create fragments that are duration microseconds long.
min_frag_duration int 0 Do not create fragments that are shorter than duration microseconds long.
frag_size int 0 Create fragments that contain up to size bytes of payload data.
ism_lookahead int 0 Specify number of lookahead entries for ISM files (from 0 to 255), default is 0.
video_track_timescale int 0 Set the timescale used for video tracks. Range is 0 to INT_MAX. If set to 0, the timescale is automatically set based on the native stream time base. Default is 0.
brand string   Override major brand.
use_editlist     Use edit list (default value is auto).
fragment_index int 1 Fragment number of the next fragment.
mov_gamma double 0.000000 Specify gamma value for gama atom (as a decimal number from 0 to 10), default is 0.0, must be set together with + movflags.
frag_interleave int 0 Interleave samples within fragments (max number of consecutive samples, lower is tighter interleaving, but with more overhead. It is set to 0 by default.
encryption_scheme string   Configure the encryption scheme, allowed values are ‘none’, and ‘cenc-aes-ctr’.
encryption_key     Set the media encryption key in hexadecimal format.
encryption_kid     Set the media encryption key identifier in hexadecimal format.
use_stream_ids_as_track_ids     Use stream ids as track ids.
write_tmcd     Force or disable writing tmcd.
display_rotation
 double   Set video rotation metadata. Rotation is a decimal number specifying the amount in degree by which the video should be rotated counter-clockwise before being displayed.

Video codecs

  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • MPEG-2 Video
  • DV Video / DVCPRO-HD
  • MJPEG (Motion JPEG)
  • FLV / Sorenson Spark / Sorenson H.263 (Flash Video)
  • HuffYUV
  • FFV1
  • MPEG-1 Video
  • Windows Media Video 8
  • Apple ProRes proxy
  • Apple ProRes 422 (LT)
  • Apple ProRes 422
  • Apple ProRes 422 (HQ)
  • QuickTime Animation (RLE) video
  • Uncompressed 4:2:2 8bit
  • Uncompressed 4:2:2 10bit
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52 E-AC-3
  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • (Uncompressed) PCM signed 32-bit little-endian
  • (Uncompressed) PCM 32-bit floating point little-endian
  • ALAC (Apple Lossless Audio Codec)
  • ADPCM IMA QuickTime
  • ATSC A/52A (AC-3) Fixed
  • Ogg Vorbis
  • ADPCM Microsoft
  • Direct stream copy
  • No Audio

MOV DNxHD

Configuration Parameter: mov_dnxhd

Extensions: mov

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
ignore_pts string   Ignore video sample times. Possible values: true, false.
movflags flags   MOV muxer flags
  • frag_keyframe - Fragment at video keyframes
  • faststart - Run a second pass to put the moov at the beginning of the file
moov_size int 0 Reserves space for the moov atom at the beginning of the file instead of placing the moov atom at the end. If the space reserved is insufficient, muxing will fail.
skip_iods int 1 Skip writing iods atom.
iods_audio_profile int -1 Specify iods number for the audio profile atom (from -1 to 255), default is -1.
iods_video_profile int -1 Specify iods number for the video profile atom (from -1 to 255), default is -1.
frag_duration int 0 Create fragments that are duration microseconds long.
min_frag_duration int 0 Specify the minimum fragment duration (in microseconds).
frag_size int 0 Create fragments that contain up to size bytes of payload data.
display_rotation
 double   Set video rotation metadata. Rotation is a decimal number specifying the amount in degree by which the video should be rotated counter-clockwise before being displayed

Video codecs

  • DNxHD 1080 60p 440M
  • DNxHD 1080 60p 290M
  • DNxHD 1080 60p 90M
  • DNxHD 1080 59p 440M
  • DNxHD 1080 59p 290M
  • DNxHD 1080 59p 90M
  • DNxHD 1080 50p 365M
  • DNxHD 1080 50p 240M
  • DNxHD 1080 50p 75M
  • DNxHD 1080 59i 220M
  • DNxHD 1080 59i 145M
  • DNxHD 1080 50i 185M
  • DNxHD 1080 50i 120M
  • DNxHD 1080 25p 185M
  • DNxHD 1080 25p 120M
  • DNxHD 1080 25p 36M
  • DNxHD 1080 24p 175M
  • DNxHD 1080 24p 115M
  • DNxHD 1080 24p 36M
  • DNxHD 1080 23p 175M
  • DNxHD 1080 23p 115M
  • DNxHD 1080 23p 36M
  • DNxHD 1080 29p 220M
  • DNxHD 1080 29p 145M
  • DNxHD 1080 29p 45M
  • DNxHD 720 59p 220M
  • DNxHD 720 59p 145M
  • DNxHD 720 50p 60M
  • DNxHD 720 25p 90M
  • DNxHR LB - Low Bandwidth (8-bit 4:2:2)
  • DNxHR SQ - Standard Quality (8-bit 4:2:2)
  • DNxHR HQ - High Quality (8-bit 4:2:2)
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52 E-AC-3
  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • (Uncompressed) PCM signed 32-bit little-endian
  • (Uncompressed) PCM 32-bit floating point little-endian
  • ALAC (Apple Lossless Audio Codec)
  • ADPCM IMA QuickTime
  • ATSC A/52A (AC-3) Fixed
  • Ogg Vorbis
  • ADPCM Microsoft
  • No Audio

XDCAM - MPEG IMX (MPEG-4 container)

Configuration Parameter: mov

Extensions: mov

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
ignore_pts string   Ignore video sample times. Possible values: true, false.
movflags flags   MOV muxer flags
  • frag_keyframe - Fragment at video keyframes
  • faststart - Run a second pass to put the moov at the beginning of the file
moov_size int 0 Reserves space for the moov atom at the beginning of the file instead of placing the moov atom at the end. If the space reserved is insufficient, muxing will fail.
skip_iods int 1 Skip writing iods atom.
iods_audio_profile int -1 Specify iods number for the audio profile atom (from -1 to 255), default is -1.
iods_video_profile int -1 Specify iods number for the video profile atom (from -1 to 255), default is -1.
frag_duration int 0 Create fragments that are duration microseconds long.
min_frag_duration int 0 Do not create fragments that are shorter than duration microseconds long.
frag_size int 0 Create fragments that contain up to size bytes of payload data.

Video codecs

  • MPEG-2 Video 30Mbps
  • MPEG-2 Video 40Mbps
  • MPEG-2 Video 50Mbps
  • Direct stream copy
  • No Video

Audio codecs

  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • Direct stream copy
  • No Audio

MXF (Material eXchange Format)

Configuration Parameter: mxf

Extensions: mxf

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
ignore_pts string   Ignore video sample times. Possible values: true, false.

Video codecs

  • MPEG-2 Video
  • DV Video / DVCPRO-HD
  • VC3/DNxHD 1080
  • VC3/DNxHD 720
  • Direct stream copy
  • No Video

Audio codecs

  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • Direct stream copy
  • No Audio

MXF D-10 (Material eXchange Format D-10 Mapping)

Configuration Parameter: mxf_d10

Extensions: mxf

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels
scc_capture option_fixed true Capture SCC Closed Captioning
anc_capture option_fixed false Capture ANC Closed Captioning
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00"
ignore_pts string   Ignore video sample times. Possible values: true, false

Video codecs

  • MPEG-2 Video 30Mbps
  • MPEG-2 Video 40Mbps
  • MPEG-2 Video 50Mbps
  • Direct stream copy

Audio codecs

  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • Direct stream copy
  • No Audio

GXF (General eXchange Format)

Configuration Parameter: gxf

Extensions: gxf

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
ignore_pts string   Ignore video sample times. Possible values: true, false.

Video codecs

  • MPEG-2 Video PAL
  • MPEG-2 Video NTSC

Audio codecs

  • (Uncompressed) PCM signed 16-bit little-endian
  • No Audio

DV (Digital Video)

Configuration Parameter: dv

Extensions: dv

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
ignore_pts string   Ignore video sample times. Possible values: true, false.

Video codecs

  • DV (Digital Video)

Audio codecs

  • (Uncompressed) PCM signed 16-bit little-endian
  • No Audio

FLV (Flash Video)

Configuration Parameter: flv

Extensions: flv

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
ignore_pts string   Ignore video sample times. Possible values: true, false.

Video codecs

  • FLV / Sorenson Spark / Sorenson H.263 (Flash Video)
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • AMD AMF H.264 Encoder
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • (Uncompressed) PCM signed 16-bit little-endian 44100Hz
  • (Uncompressed) PCM signed 16-bit little-endian 22050Hz
  • No Audio

DVD Video (VOB-Files)

Configuration Parameter: vob

Extensions: vob

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
ignore_pts string   Ignore video sample times. Possible values: true, false
muxrate int 0 The combined rate of all video and audio elementary stream packets common to one program. This rate also includes the VBI and sub-picture private stream data, which MPEG treats as a private stream type.
preload int 500000 Initial demux-decode delay in microseconds.

Video codecs

  • MPEG-2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • MPEG-1 Video
  • MPEG-4 part 2 Video
  • No Video

Audio codecs

  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • No Audio

ASF (Advanced / Active Streaming Format)

Configuration Parameter: asf

Extensions: asf,wmv,wma

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
ignore_pts string   Ignore video sample times. Possible values: true, false.

Video codecs

  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • AMD AMF H.264 Encoder
  • Windows Media Video 8
  • MPEG-2 Video
  • MJPEG (Motion JPEG)
  • HuffYUV
  • Google VP8
  • Google VP9
  • DV Video / DVCPRO-HD
  • FLV / Sorenson Spark / Sorenson H.263 (Flash Video)
  • MPEG-1 Video
  • No Video

Audio codecs

  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • AAC (Advanced Audio Coding)
  • ATSC A/52A (AC-3)
  • (Uncompressed) PCM 32-bit floating point little-endian
  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • (Uncompressed) PCM signed 32-bit little-endian
  • ADPCM Microsoft
  • Ogg Vorbis
  • No Audio

iPod MP4 (MPEG-4 Part 14)

Configuration Parameter: ipod

Extensions: m4v,m4a

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
ignore_pts string   Ignore video sample times. Possible values: true, false.
movflags flags   MOV muxer flags
  • frag_keyframe - Fragment at video keyframes
  • faststart - Run a second pass to put the moov at the beginning of the file
moov_size int 0 Reserves space for the moov atom at the beginning of the file instead of placing the moov atom at the end. If the space reserved is insufficient, muxing will fail.
skip_iods int 1 Skip writing iods atom.
iods_audio_profile int -1 Specify iods number for the audio profile atom (from -1 to 255), default is -1.
iods_video_profile int -1 Specify iods number for the video profile atom (from -1 to 255), default is -1.
frag_duration int 0 Create fragments that are duration microseconds long.
min_frag_duration int 0 Minimum fragment duration (in microseconds), default value is 1 second (10000000).
frag_size int 0 Create fragments that contain up to size bytes of payload data.
display_rotation
 double   Set video rotation metadata. Rotation is a decimal number specifying the amount in degree by which the video should be rotated counter-clockwise before being displayed.

Video codecs

  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • x265 H.265/HEVC
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • ATSC A/52A (AC-3)
  • ALAC (Apple Lossless Audio Codec)
  • No Audio

AVI (Audio Video Interleaved)

Configuration Parameter: avi

Extensions: avi

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
scc_capture option_fixed true Capture SCC Closed Captioning.
anc_capture option_fixed false Capture ANC Closed Captioning.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
ignore_pts string   Ignore video sample times. Possible values: true, false.
reserve_index_space int 0

Reserve the specified amount of bytes for the OpenDML master index of each stream within the file header. By default additional master indexes are embedded within the data packets if there is no space left in the first master index and are linked together as a chain of indexes. This index structure can cause problems for some use cases, e.g. third-party software strictly relying on the OpenDML index specification or when file seeking is slow. Reserving enough index space in the file header avoids these problems.

The required index space depends on the output file size and should be about 16 bytes per gigabyte. When this option is omitted or set to zero the necessary index space is guessed.

Default value is 0.
write_channel_mask     Write the channel layout mask into the audio stream header. This option is enabled by default. Disabling the channel mask can be useful in specific scenarios, e.g. when merging multiple audio streams into one for compatibility with software that only supports a single audio stream in AVI.

Video codecs

  • MPEG-4 part 2 Video
  • MPEG-2 Video
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Windows Media Video 8
  • MJPEG (Motion JPEG)
  • DV Video / DVCPRO-HD
  • HuffYUV
  • FFV1
  • Google VP8
  • Google VP9
  • FLV / Sorenson Spark / Sorenson H.263 (Flash Video)
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • MPEG-1 Video
  • OpenJPEG JPEG 2000
  • Uncompressed 4:2:2 8bit
  • Uncompressed 4:2:2 10bit
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • MP2 (MPEG audio layer 2)
  • (Uncompressed) PCM 32-bit floating point little-endian
  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • (Uncompressed) PCM signed 32-bit little-endian
  • ADPCM Microsoft
  • MP3 Lame (MPEG audio layer 3)
  • Ogg Vorbis
  • Direct stream copy
  • No Audio

MKV (Matroska)

Configuration Parameter: matroska

Extensions: mkv

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels
scc_capture option_fixed true Capture SCC Closed Captioning
anc_capture option_fixed false Capture ANC Closed Captioning
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
raw_video string   Capture RAW video. Set target save path as value.
raw_audio string   Capture RAW audio. Set target save path as value.
ignore_pts string   Ignore video sample times. Possible values: true, false.
reserve_index_space int 0

By default, this muxer writes the index for seeking (called cues in Matroska terms) at the end of the file, because it cannot know in advance how much space to leave for the index at the beginning of the file. However for some use cases – e.g. streaming where seeking is possible but slow – it is useful to put the index at the beginning of the file.

If this option is set to a non-zero value, the muxer will reserve size bytes of space in the file header and then try to write the cues there when the muxing finishes. If the reserved space does not suffice, no Cues will be written, the file will be finalized and writing the trailer will return an error. A safe size for most use cases should be about 50kB per hour of video.

Note that cues are only written if the output is seekable and this option will have no effect if it is not.
cluster_size_limit int -1 Store at most the provided amount of bytes in a cluster. If not specified, the limit is set automatically to a sensible hardcoded fixed value.
cluster_time_limit int64 -1 Store at most the provided number of milliseconds in a cluster. If not specified, the limit is set automatically to a sensible hardcoded fixed value.
dash     Create a WebM file conforming to WebM DASH specification. By default it is set to false.
dash_track_number int 1 Track number for the DASH stream. By default it is set to 1.
live     Write files assuming it is a live stream. By default it is set to false.
allow_raw_vfw     Allow raw VFW mode. By default it is set to false.
write_crc32     Write a CRC32 element inside every Level 1 element. By default it is set to true. This option is ignored for WebM.

Video codecs

  • MPEG-4 part 2 Video
  • DV Video / DVCPRO-HD
  • FLV / Sorenson Spark / Sorenson H.263 (Flash Video)
  • Cisco OpenH264 Encoder
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • NVIDIA NVEnc AV1 Encode
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Apple ProRes
  • HuffYUV
  • MJPEG (Motion JPEG)
  • MPEG-1 Video
  • MPEG-2 Video
  • FFV1
  • Google VP8
  • Google VP9
  • Windows Media Video 8
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM signed 24-bit little-endian
  • (Uncompressed) PCM signed 32-bit little-endian
  • MP2 (MPEG audio layer 2)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • ALAC (Apple Lossless Audio Codec)
  • Direct stream copy
  • No Audio

WebM

Configuration Parameter: webm

Extensions: webm

Additional attributes

Name Type Default Description
reserve_index_space int 0 Reserve a given amount of space (in bytes) at the beginning of the file for the index (cues).
cluster_size_limit int -1 Store at most the provided amount of bytes in a cluster. If not specified, the limit is set automatically to a sensible hardcoded fixed value.
cluster_time_limit int64 -1 Store at most the provided number of milliseconds in a cluster. If not specified, the limit is set automatically to a sensible hardcoded fixed value.
dash     Create a WebM file conforming to WebM DASH specification. By default it is set to false.
dash_track_number int 1 Track number for the DASH stream. By default it is set to 1.
live     Write files assuming it is a live stream. By default it is set to false.
allow_raw_vfw     Allow raw VFW mode. By default it is set to false.
write_crc32     Write a CRC32 element inside every Level 1 element. By default it is set to true. This option is ignored for WebM.

Video codecs

  • Google VP8
  • Google VP9
  • NVIDIA NVEnc AV1 Encoder

Audio codecs

  • Ogg Vorbis
  • No Audio

RTMP Streaming

Configuration Parameter: flv

Extensions: rtmp://

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels
merge_tracks option_fixed true Merge audio tracks
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
rtmp_app string   Name of application to connect on the RTMP server. This option overrides the parameter specified in the URI.
rtmp_buffer string   Set the client buffer time in milliseconds. The default is 3000.
rtmp_flashver string   Version of the Flash plugin used to run the SWF player. The default is LNX 9,0,124,2. (When publishing, the default is FMLE/3.0 (compatible; 'libavformat version').
rtmp_live string   Specify that the media is a live stream. No resuming or seeking in live streams is possible. The default value is any, which means the subscriber first tries to play the live stream specified in the playpath. If a live stream of that name is not found, it plays the recorded stream. The other possible values are live and recorded.
rtmp_pageurl string   URL of the web page in which the media was embedded. By default no value will be sent.
rtmp_playpath string   Stream identifier to play or to publish. This option overrides the parameter specified in the URI.
rtmp_subscribe string   Name of live stream to subscribe to. By default no value will be sent. It is only sent if the option is specified or if rtmp_live is set to live.

Video codecs

  • FLV / Sorenson Spark / Sorenson H.263 (Flash Video)
  • Cisco OpenH264 Encoder
  • H.264 / MPEG-4 AVC
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • NVIDIA NVEnc H.264 Encoder
  • AMD AMF H.264 Encoder
  • Direct stream copy
  • No Video

Audio codecs

  • MP3 Lame (MPEG audio layer 3)
  • PCM signed 16-bit little-endian
  • AAC (Advanced Audio Coding)
  • Direct stream copy
  • No Audio

UDP Streaming

Configuration Parameter: mpegts

Extensions: udp://

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
embed_scte35 bool false Enable embedding SCTE-35 triggers into MPEG transport stream.
mpegts_transport_stream_id int 1 Set the transport_stream_id. This identifies a transponder in DVB. Default is 0x0001.
mpegts_original_network_id int 65281 Set the ‘original_network_id’. This is unique identifier of a network in DVB. Its main use is in the unique identification of a service through the path ‘Original_Network_ID, Transport_Stream_ID’.
mpegts_service_id int 1 Set the ‘service_id’, also known as program in DVB. Default is 0x0001.
mpegts_service_type option digital_tv Set service_type field.
  • digital_tv - Digital Television.
  • digital_radio - Digital Radio.
  • teletext - Teletext.
  • advanced_codec_digital_radio - Advanced Codec Digital Radio.
  • mpeg2_digital_hdtv - MPEG2 Digital HDTV.
  • advanced_codec_digital_sdtv - Advanced Codec Digital SDTV.
  • advanced_codec_digital_hdtv - Advanced Codec Digital HDTV.
  • hevc_digital_hdtv - HEVC Digital Television Service.
mpegts_pmt_start_pid int 4096 Set the first PID for PMTs. Default is 0x1000, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the PMT PID is fixed 0x0100.
mpegts_start_pid int 256 Set the first PID for elementary streams. Default is 0x0100, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the elementary stream PIDs are fixed.
mpegts_m2ts_mode     Enable m2ts mode if set to 1. Default value is -1 which disables m2ts mode.
muxrate int 1 Set a constant muxrate. Default is VBR.
pes_payload_size int 2930 Set minimum PES packet payload in bytes. Default is 2930.
mpegts_flags flags   MPEG-TS muxing flags
  • resend_headers - Reemit PAT/PMT before writing the next packet
  • latm - Use LATM packetization for AAC
  • pat_pmt_at_frames - Reemit PAT and PMT at each video frame
  • system_b - Conform to System B (DVB) instead of System A (ATSC)
  • initial_discontinuity - Mark initial packets as discontinuous
resend_headers int 0 Reemit PAT/PMT before writing the next packet.
mpegts_copyts     Preserve original timestamps, if value is set to 1. Default value is -1, which results in shifting timestamps so that they start from 0.
tables_version int 0 Set PAT, PMT, SDT and NIT version (default 0, valid values are from 0 to 31, inclusively). This option allows updating stream structure so that standard consumer may detect the change.
omit_video_pes_length     Omit the PES packet length for video packets.
pcr_period int 20 Override the default PCR retransmission time in milliseconds. Default is -1 which means that the PCR interval will be determined automatically: 20 ms is used for CBR streams, the highest multiple of the frame duration which is less than 100 ms is used for VBR streams.
pat_period double 2147483647.000000 PAT/PMT retransmission time limit in seconds.
sdt_period double 2147483647.000000 SDT retransmission time limit in seconds.
flush_packets int -1 Enable flushing of the I/O context after each packet.

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • H.264 / MPEG-4 AVC
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • MJPEG (Motion JPEG)
  • Direct stream copy
  • No Video

Audio codecs

  • MP3 Lame (MPEG audio layer 3)
  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

DVB Compatible Streaming

Configuration Parameter: dvb

Extensions: udp://

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
embed_scte35 bool false Enable embedding SCTE-35 triggers into MPEG transport stream
service_name string MPService001 Set Service Name
service_provider string Medialooks MPlatform 1.7 Set Service Provider
transport_stream_id int 1 Set the ‘transport_stream_id’. This identifies a transponder in DVB. Default is 0x0001.
original_network_id int 1 Set the ‘original_network_id’. This is unique identifier of a network in DVB. Its main use is in the unique identification of a service through the path ‘Original_Network_ID, Transport_Stream_ID’. Default is 0x0001.
muxrate int 1 Set a constant muxrate. Default is VBR.
service_id int 1 Set service_id field.
service_type option_fixed digital_tv Service type
pmt_start_pid int 129 Set the first pid of the PMT
start_pid int 1024 Set the first pid.
pes_payload_size int 2930 Set minimum PES packet payload in bytes. Default is 2930.
mpegts_flags flags +system_b MPEG-TS muxing flags
  • resend_headers - Reemit PAT/PMT before writing the next packet
  • pat_pmt_at_frames - Reemit PAT and PMT at each video frame
  • latm - Use LATM packetization for AAC
  • system_b - Conform to System B (DVB) instead of System A (ATSC)
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00".
resend_headers int 0 Reemit PAT/PMT before writing the next packet.
tables_version int 0 Set PAT, PMT, SDT and NIT version (default 0, valid values are from 0 to 31, inclusively). This option allows updating stream structure so that standard consumer may detect the change.
rc_buffers int 8 Rate-Control buffers.
rc_sync_msec int 1 Rate-Control precision (in msec, miminum 1 msec).
rc_max_underflow_msec int 30 Rate-Control max underflow time, after this time the clock corrected (in msec).
pcr_period int 20 Override the default PCR retransmission time in milliseconds. Default is -1 which means that the PCR interval will be determined automatically: 20 ms is used for CBR streams, the highest multiple of the frame duration which is less than 100 ms is used for VBR streams.
pat_period double 0.1 PAT/PMT retransmission time limit in seconds (default 100 msec).
sdt_period double 0.5 SDT retransmission time limit in seconds (default 500 msec).
nit_period double 9.0 NIT retransmission time limit in seconds (default 3 s).
tdt_period double 25.0 TDT retransmission time limit in seconds (default 10 s).
eit_period double 1.5 EIT present/following retransmission time limit in seconds (default 0.5 s).
flush_packets int -1 Enable flushing of the I/O context after each packet.
max_delay int 700000 Set maximum multiplexing PTS/PCR delay in microseconds.

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • H.264 / MPEG-4 AVC
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

 

RIST Streaming

Configuration Parameter: mpegts

Extensions: rist://

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
embed_scte35 bool false Enable embedding SCTE-35 triggers into MPEG transport stream.
rist_profile string main

Possible values:

  • simple
  • main
  • advanced
buffer_size int   Set internal RIST buffer size in milliseconds for retransmission of data. Default value is 0 which means the librist default (1 sec). Maximum value is 30000 milliseconds.
fifo_size int 8192 Set fifo buffer size, must be a power of 2.
overrun_nonfatal bool false Survive in case of receiving fifo buffer overrun.
pkt_size int 1316 Set maximum packet size for sending data.
log_level int   Set loglevel for RIST logging messages. You only need to set this if you explicitly want to enable debug level messages or packet loss simulation, otherwise the regular loglevel is respected.
secret string   Set override of encryption secret, by default is unset.
encryption string   Set encryption type, by default is disabled. Acceptable values are 128 and 256.
mpegts_transport_stream_id int 1 Set the ‘transport_stream_id’. This identifies a transponder in DVB. Default is 0x0001.
mpegts_original_network_id int 65281 Set the ‘original_network_id’. This is unique identifier of a network in DVB. Its main use is in the unique identification of a service through the path ‘Original_Network_ID, Transport_Stream_ID’.
mpegts_service_id int 1 Set the ‘service_id’, also known as program in DVB. Default is 0x0001.
mpegts_service_type option digital_tv

Set the program ‘service_type’. Default is digital_tv. Accepts the following options:

  • hex_value - Any hexadecimal value between 0x01 and 0xff as defined in ETSI 300 468.
  • digital_tv - Digital TV service.
  • digital_radio - Digital Radio service.
  • teletext - Teletext service.
  • advanced_codec_digital_radio - Advanced Codec Digital Radio service.
  • mpeg2_digital_hdtv - MPEG2 Digital HDTV service.
  • advanced_codec_digital_sdtv - Advanced Codec Digital SDTV service.
  • advanced_codec_digital_hdtv - Advanced Codec Digital HDTV service.
mpegts_pmt_start_pid int 4096 Set the first PID for PMTs. Default is 0x1000, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the PMT PID is fixed 0x0100.
mpegts_start_pid int 256 Set the first PID for elementary streams. Default is 0x0100, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the elementary stream PIDs are fixed.
mpegts_m2ts_mode string   Enable m2ts mode.
muxrate int 1 Set a constant muxrate. Default is VBR.
pes_payload_size int 2930 Minimum PES packet payload in bytes.
mpegts_flags flags  

Set mpegts flags. Accepts the following options:

  • resend_headers - Reemit PAT/PMT before writing the next packet.
  • latm - Use LATM packetization for AAC.
  • pat_pmt_at_frames - Reemit PAT and PMT at each video frame.
  • system_b - Conform to System B (DVB) instead of System A (ATSC).
  • initial_discontinuity - Mark the initial packet of each stream as discontinuity.
  • nit - Emit NIT table.
  • omit_rai - Disable writing of random access indicator.
resend_headers int 0 Reemit PAT/PMT before writing the next packet.
mpegts_copyts string   Preserve original timestamps, if value is set to 1. Default value is -1, which results in shifting timestamps so that they start from 0.
tables_version int 0 Set PAT, PMT, SDT and NIT version (default 0, valid values are from 0 to 31, inclusively). This option allows updating stream structure so that standard consumer may detect the change.
omit_video_pes_length bool true Omit the PES packet length for video packets. Default value is true.
pcr_period int 20 Override the default PCR retransmission time in milliseconds. Default is -1 which means that the PCR interval will be determined automatically: 20 ms is used for CBR streams, the highest multiple of the frame duration which is less than 100 ms is used for VBR streams.
pat_period double   PAT/PMT retransmission time limit in seconds
sdt_period double   Maximum time in seconds between SDT tables.

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • H.264 / MPEG-4 AVC
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

 

 

 

SRT - Secure Reliable Tranport

Configuration Parameter: mpegts

Extensions: srt://

Additional attributes

Name Type Default Description
maxbw int -1 Maximum send bandwidth. -1: infinite (CSRTCC limit is 30mbps) = 0: relative to input rate.
pbkeylen option_fixed 0 Sender encryption key length, in bytes. Only can be set to 0, 16, 24 and 32. Enable sender encryption if not 0. Not required on receiver (set to 0), key size obtained from sender in HaiCrypt handshake. Default value is 0.
passphrase string   Sets the passphrase for encryption. This turns encryption on on this side (or turns it off, if empty passphrase is passed).
mss int 1500 Maximum Segment Size. Used for buffer allocation and rate calculation using packet counter assuming fully filled packets. The smallest MSS between the peers is used. This is 1500 by default in the overall internet. This is the maximum size of the UDP packet and can be only decreased, unless you have some unusual dedicated network settings. Not to be mistaken with the size of the UDP payload or SRT payload — this size is the size of the IP packet, including the UDP and SRT headers.
fc int 25600 Flight Flag Size (maximum number of bytes that can be sent without being acknowledged).
sndbuf int 12058624 Send Buffer Size. Warning: configured in bytes, converted in packets, when set, based on MSS value. For desired result, configure MSS first. Default value: 8192 × (1500-28).
rcvbuf int 12058624 Receive Buffer Size. Receive buffer must not be greater than FC size. Warning: configured in bytes, converted in packets when set based on MSS value. For desired result, configure MSS first. Default value: 8192 × (1500-28).
ipttl option_fixed 32 IPv4 Time To Live (see IP_TTL option for IP) or IPv6 unicast hops (see IPV6_UNICAST_HOPS for IPV6) depending on socket address family. Applies to sender only.
iptos int 184 IPv4 Type of Service (see IP_TOS option for IP) or IPv6 Traffic Class (see IPV6_TCLASS of IPv6) depending on socket address family. Applies to sender only. Default: 0xB8.
inputbw int 0 Sender nominal input rate. Used along with OHEADBW, when MAXBW is set to relative (0), to calculate maximum sending rate when recovery packets are sent along with main media stream (INPUTBW × (100 + OHEADBW) / 100). If INPUTBW is not set while MAXBW is set to relative (0), the actual input rate is evaluated inside the library.
oheadbw int 25 Recovery bandwidth overhead above input rate (see SRTO_INPUTBW). Sender: user configurable, default: 25%.
latency int 0 This flag sets both SRTO_RCVLATENCY and SRTO_PEERLATENCY to the same value. Note that prior to version 1.3.0 this is the only flag to set the latency, however this is effectively equivalent to setting SRTO_PEERLATENCY, when the side is sender (see SRTO_SENDER) and SRTO_RCVLATENCY when the side is receiver, and the bidirectional stream sending in version 1.2.0is not supported.
tsbpddelay     Receiver's buffer delay (or receiver's buffer latency, or SRT Latency). This is the time, in milliseconds, that SRT holds a packet from the moment it has been received till the time it should be delivered to the upstream application.
tlpktdrop bool true Too-late Packet Drop. When enabled on receiver, it skips missing packets that have not been delivered in time and delivers the subsequent packets to the application when their time-to-play has come. It also sends a fake ACK to the sender. When enabled on sender and enabled on the receiving peer, sender drops the older packets that have no chance to be delivered in time. It is automatically enabled in sender if receiver supports it.
snddropdelay     The sender’s extra delay before dropping packets. This delay is added to the default drop delay time interval value.
nakreport bool true When set to true, Receiver will send UMSG_LOSSREPORT messages periodically until the lost packet is retransmitted or intentionally dropped.
conntimeo int 3000 Connect timeout. SRT cannot connect for RTT > 1500 msec (2 handshake exchanges) with the default connect timeout of 3 seconds. This option applies to the caller and rendezvous connection modes. The connect timeout is 10 times the value set for the rendezvous mode (which can be used as a workaround for this connection problem with earlier versions).
lossmaxttl int 0 The value up to which the Reorder Tolerance may grow. When Reorder Tolerance is > 0, then packet loss report is delayed until that number of packets come in. Reorder Tolerance increases every time a "belated" packet has come, but it wasn't due to retransmission (that is, when UDP packets tend to come out of order), with the difference between the latest sequence and this packet's sequence, and not more than the value of this option. By default it's 0, which means that this mechanism is turned off, and the loss report is always sent immediately upon experiencing a "gap" in sequences.
rcvlatency int 0 The time that should elapse since the moment when the packet was sent and the moment when it's delivered to the receiver application in the receiving function. This time should be a buffer time large enough to cover the time spent for sending, unexpectedly extended RTT time, and the time needed to retransmit the lost UDP packet. The effective latency value will be the maximum of this options' value and the value of SRTO_PEERLATENCY set by the peer side.
peerlatency int 0 The latency value (as described in SRTO_RCVLATENCY) that is set by the sender side as a minimum value for the receiver.
minversion int 0 The minimum SRT version that is required from the peer. A connection to a peer that does not satisfy the minimum version requirement will be rejected.
streamid string   A string limited to 512 characters that can be set on the socket prior to connecting. This stream ID will be able to be retrieved by the listener side from the socket that is returned from srt_accept and was connected by a socket with that set stream ID. SRT does not enforce any special interpretation of the contents of this string. As this uses internally the std::string type, there are additional functions for it in the legacy/C++ API (udt.h): UDT::setstreamid and UDT::getstreamid. This option doesn’t make sense in Rendezvous connection; the result might be that simply one side will override the value from the other side and it’s the matter of luck which one would win.
smoother option_fixed live The type of Smoother used for the transmission for that socket, which is responsible for the transmission and congestion control. The Smoother type must be exactly the same on both connecting parties, otherwise the connection is rejected.
messageapi bool true When set, this socket uses the Message API[*], otherwise it uses Buffer API. Note that in live mode (see SRTO_TRANSTYPE option) there’s only message API available.
payloadsize int 1316 Sets the maximum declared size of a single call to sending function in Live mode. Use 0 if this value isn't used (which is default in file mode). This value shall not be exceeded for a single data sending instruction in Live mode/ Range: up to MTUsize-28-16, usually 1456.
transtype     Sets the transmission type for the socket, in particular, setting this option sets multiple other parameters to their default values as required for a particular transmission type. Type: enum. Default: SRTT_LIVE. Range: SRTT_FILE.
kmrefreshrate     The number of packets to be transmitted after which the encryption key is switched to a new key. Default is -1. -1 means auto (0x1000000 in srt library). The range for this option is integers in the 0 - INT_MAX.
kmpreannounce     The interval between when a new encryption key is sent and when switchover occurs. This value also applies to the subsequent interval between when switchover occurs and when the old encryption key is decommissioned. Default is -1. -1 means auto (0x1000 in srt library). The range for this option is integers in the 0 - INT_MAX.
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
embed_scte35 bool false Enable embedding SCTE-35 triggers into MPEG transport stream.
mpegts_transport_stream_id int 1 Set the ‘transport_stream_id’. This identifies a transponder in DVB. Default is 0x0001.
mpegts_original_network_id int 65281 Set the ‘original_network_id’. This is unique identifier of a network in DVB. Its main use is in the unique identification of a service through the path ‘Original_Network_ID, Transport_Stream_ID’.
mpegts_service_id int 1 Set the ‘service_id’, also known as program in DVB. Default is 0x0001.
mpegts_service_type option digital_tv Set service_type field.
  • digital_tv - Digital Television.
  • digital_radio - Digital Radio.
  • teletext - Teletext.
  • advanced_codec_digital_radio - Advanced Codec Digital Radio.
  • mpeg2_digital_hdtv - MPEG2 Digital HDTV.
  • advanced_codec_digital_sdtv - Advanced Codec Digital SDTV.
  • advanced_codec_digital_hdtv - Advanced Codec Digital HDTV.
  • hevc_digital_hdtv - HEVC Digital Television Service.
mpegts_pmt_start_pid int 4096 Set the first PID for PMTs. Default is 0x1000, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the PMT PID is fixed 0x0100.
mpegts_start_pid int 256 Set the first PID for elementary streams. Default is 0x0100, minimum is 0x0020, maximum is 0x1ffa. This option has no effect in m2ts mode where the elementary stream PIDs are fixed.
mpegts_m2ts_mode     Enable m2ts mode if set to 1. Default value is -1 which disables m2ts mode.
muxrate int 1 Set a constant muxrate. Default is VBR.
pes_payload_size int 2930 Set minimum PES packet payload in bytes. Default is 2930.
mpegts_flags flags   MPEG-TS muxing flags
  • resend_headers - Reemit PAT/PMT before writing the next packet
  • latm - Use LATM packetization for AAC
  • pat_pmt_at_frames - Reemit PAT and PMT at each video frame
  • system_b - Conform to System B (DVB) instead of System A (ATSC)
  • initial_discontinuity - Mark initial packets as discontinuous
resend_headers int 0 Reemit PAT/PMT before writing the next packet.
mpegts_copyts     Preserve original timestamps, if value is set to 1. Default value is -1, which results in shifting timestamps so that they start from 0.
tables_version int 0 Set PAT, PMT, SDT and NIT version (default 0, valid values are from 0 to 31, inclusively). This option allows updating stream structure so that standard consumer may detect the change.
omit_video_pes_length     Omit the PES packet length for video packets.
pcr_period int 20 Override the default PCR retransmission time in milliseconds. Default is -1 which means that the PCR interval will be determined automatically: 20 ms is used for CBR streams, the highest multiple of the frame duration which is less than 100 ms is used for VBR streams.
pat_period double 2147483647.000000 PAT/PMT retransmission time limit in seconds.
sdt_period double 2147483647.000000 Maximum time in seconds between SDT tables.

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • H.264 / MPEG-4 AVC
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Direct stream copy
  • No Video

Audio codecs

  • MP3 Lame (MPEG audio layer 3)
  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

SRT - Secure Reliable Tranport (DVB Compatible)

Configuration Parameter: dvb

Extensions: srt://

Additional attributes

Name Type Default Description
maxbw int -1 Maximum send bandwidth. -1: infinite (CSRTCC limit is 30mbps) = 0: relative to input rate.
pbkeylen option_fixed 0 Sender encryption key length, in bytes. Only can be set to 0, 16, 24 and 32. Enable sender encryption if not 0. Not required on receiver (set to 0), key size obtained from sender in HaiCrypt handshake. Default value is 0.
passphrase string   Sets the passphrase for encryption. This turns encryption on on this side (or turns it off, if empty passphrase is passed).
mss int 1500 Maximum Segment Size. Used for buffer allocation and rate calculation using packet counter assuming fully filled packets. The smallest MSS between the peers is used. This is 1500 by default in the overall internet. This is the maximum size of the UDP packet and can be only decreased, unless you have some unusual dedicated network settings. Not to be mistaken with the size of the UDP payload or SRT payload — this size is the size of the IP packet, including the UDP and SRT headers.
fc int 25600 Flight Flag Size (maximum number of bytes that can be sent without being acknowledged).
sndbuf int 12058624 Send Buffer Size. Warning: configured in bytes, converted in packets, when set, based on MSS value. For desired result, configure MSS first. Default value: 8192 × (1500-28).
rcvbuf int 12058624 Receive Buffer Size. Receive buffer must not be greater than FC size. Warning: configured in bytes, converted in packets when set based on MSS value. For desired result, configure MSS first. Default value: 8192 × (1500-28).
ipttl option_fixed 32 IPv4 Time To Live (see IP_TTL option for IP) or IPv6 unicast hops (see IPV6_UNICAST_HOPS for IPV6) depending on socket address family. Applies to sender only.
iptos int 184 IPv4 Type of Service (see IP_TOS option for IP) or IPv6 Traffic Class (see IPV6_TCLASS of IPv6) depending on socket address family. Applies to sender only. Default: 0xB8.
inputbw int 0 Sender nominal input rate. Used along with OHEADBW, when MAXBW is set to relative (0), to calculate maximum sending rate when recovery packets are sent along with main media stream (INPUTBW × (100 + OHEADBW) / 100). If INPUTBW is not set while MAXBW is set to relative (0), the actual input rate is evaluated inside the library.
oheadbw int 25 Recovery bandwidth overhead above input rate (see SRTO_INPUTBW). Sender: user configurable, default: 25%.
latency int 0 This flag sets both SRTO_RCVLATENCY and SRTO_PEERLATENCY to the same value. Note that prior to version 1.3.0 this is the only flag to set the latency, however this is effectively equivalent to setting SRTO_PEERLATENCY, when the side is sender (see SRTO_SENDER) and SRTO_RCVLATENCY when the side is receiver, and the bidirectional stream sending in version 1.2.0is not supported.
tsbpddelay     Receiver's buffer delay (or receiver's buffer latency, or SRT Latency). This is the time, in milliseconds, that SRT holds a packet from the moment it has been received till the time it should be delivered to the upstream application.
tlpktdrop bool true Too-late Packet Drop. When enabled on receiver, it skips missing packets that have not been delivered in time and delivers the subsequent packets to the application when their time-to-play has come. It also sends a fake ACK to the sender. When enabled on sender and enabled on the receiving peer, sender drops the older packets that have no chance to be delivered in time. It is automatically enabled in sender if receiver supports it.
snddropdelay     The sender’s extra delay before dropping packets. This delay is added to the default drop delay time interval value. Special value -1: Do not drop packets on the sender at all.
nakreport bool true When set to true, Receiver will send UMSG_LOSSREPORT messages periodically until the lost packet is retransmitted or intentionally dropped.
conntimeo int 3000 Connect timeout. SRT cannot connect for RTT > 1500 msec (2 handshake exchanges) with the default connect timeout of 3 seconds. This option applies to the caller and rendezvous connection modes. The connect timeout is 10 times the value set for the rendezvous mode (which can be used as a workaround for this connection problem with earlier versions).
lossmaxttl int 0 The value up to which the Reorder Tolerance may grow. When Reorder Tolerance is > 0, then packet loss report is delayed until that number of packets come in. Reorder Tolerance increases every time a "belated" packet has come, but it wasn't due to retransmission (that is, when UDP packets tend to come out of order), with the difference between the latest sequence and this packet's sequence, and not more than the value of this option. By default it's 0, which means that this mechanism is turned off, and the loss report is always sent immediately upon experiencing a "gap" in sequences.
rcvlatency int 0 The time that should elapse since the moment when the packet was sent and the moment when it's delivered to the receiver application in the receiving function. This time should be a buffer time large enough to cover the time spent for sending, unexpectedly extended RTT time, and the time needed to retransmit the lost UDP packet. The effective latency value will be the maximum of this options' value and the value of SRTO_PEERLATENCY set by the peer side.
peerlatency int 0 The latency value (as described in SRTO_RCVLATENCY) that is set by the sender side as a minimum value for the receiver.
minversion int 0 The minimum SRT version that is required from the peer. A connection to a peer that does not satisfy the minimum version requirement will be rejected.
streamid string   A string limited to 512 characters that can be set on the socket prior to connecting. This stream ID will be able to be retrieved by the listener side from the socket that is returned from srt_accept and was connected by a socket with that set stream ID. SRT does not enforce any special interpretation of the contents of this string. As this uses internally the std::string type, there are additional functions for it in the legacy/C++ API (udt.h): UDT::setstreamid and UDT::getstreamid. This option doesn’t make sense in Rendezvous connection; the result might be that simply one side will override the value from the other side and it’s the matter of luck which one would win.
smoother option_fixed live The type of Smoother used for the transmission for that socket, which is responsible for the transmission and congestion control. The Smoother type must be exactly the same on both connecting parties, otherwise the connection is rejected.
messageapi bool true When set, this socket uses the Message API[*], otherwise it uses Buffer API. Note that in live mode (see SRTO_TRANSTYPE option) there’s only message API available.
payloadsize int 1316 Sets the maximum declared size of a single call to sending function in Live mode. Use 0 if this value isn't used (which is default in file mode). This value shall not be exceeded for a single data sending instruction in Live mode/ Range: up to MTUsize-28-16, usually 1456.
transtype     Sets the transmission type for the socket, in particular, setting this option sets multiple other parameters to their default values as required for a particular transmission type. Type: enum. Default: SRTT_LIVE. Range: SRTT_FILE.
kmrefreshrate     The number of packets to be transmitted after which the encryption key is switched to a new key. Default is -1. -1 means auto (0x1000000 in srt library). The range for this option is integers in the 0 - INT_MAX.
kmpreannounce     The interval between when a new encryption key is sent and when switchover occurs. This value also applies to the subsequent interval between when switchover occurs and when the old encryption key is decommissioned. Default is -1. -1 means auto (0x1000 in srt library). The range for this option is integers in the 0 - INT_MAX.
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
embed_scte35 bool false Enable embedding SCTE-35 triggers into MPEG transport stream.
service_name string MPService001 Set Service Name.
service_provider string Medialooks MPlatform 1.7 Set Service Provider.
transport_stream_id int 1 Set transport_stream_id field.
original_network_id int 1 Set original_network_id field.
muxrate int 1 The combined rate of all video and audio elementary stream packets common to one program. This rate also includes the VBI and sub-picture private stream data, which MPEG treats as a private stream type.
service_id int 1 Set service_id field.
service_type option_fixed digital_tv Service type.
pmt_start_pid int 129 Set the first pid of the PMT.
start_pid int 1024 Set the first pid.
pes_payload_size int 2930 Set minimum PES packet payload in bytes. Default is 2930.
mpegts_flags flags +system_b MPEG-TS muxing flags
  • resend_headers - Reemit PAT/PMT before writing the next packet
  • pat_pmt_at_frames - Reemit PAT and PMT at each video frame
  • latm - Use LATM packetization for AAC
  • system_b - Conform to System B (DVB) instead of System A (ATSC)
start_timecode option auto Set start timecode for encoding. Possible values are: auto (default), disabled, local_time or a custom string like "10:00:00:00"
resend_headers int 0 Reemit PAT/PMT before writing the next packet.
tables_version int 0 Set PAT, PMT, SDT and NIT version (default 0, valid values are from 0 to 31, inclusively). This option allows updating stream structure so that standard consumer may detect the change.
rc_buffers int 8 Rate-Control buffers.
rc_sync_msec int 1 Rate-Control precision (in msec, miminum 1 msec).
rc_max_underflow_msec int 30 Rate-Control max underflow time, after this time the clock corrected (in msec).
pcr_period int 20 Override the default PCR retransmission time in milliseconds (default 20ms).
pat_period double 0.1 PAT/PMT retransmission time limit in seconds (default 100 msec).
sdt_period double 0.5 SDT retransmission time limit in seconds (default 500 msec).

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • H.264 / MPEG-4 AVC
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • MP2 (MPEG audio layer 2)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

RTP

Configuration Parameter: rtp

Extensions:

Additional attributes

Name Type Default Description
sdp string C:\Config.sdp Path to .sdp file. This file contains sdp information for an output stream to file. This allows dumping sdp information when at least one output isn’t an rtp stream. (Requires at least one of the output formats to be rtp).
rtpflags flags   Add RTP hinting tracks to the output file.The following flags can be used:
  • latm - Use MP4A-LATM packetization instead of MPEG4-GENERIC for AAC
  • rfc2190 - Use RFC 2190 packetization instead of RFC 4629 for H.263
  • skip_rtcp - Don't send RTCP sender reports
  • h264_mode0 - Use mode 0 for H.264 in RTP
  • send_bye - Send RTCP BYE packets when finishing
payload_type int -1 Specify RTP payload type.
ssrc int 0 Stream identifier.
cname string   CNAME to include in RTCP SR packets.
seq int -1 Starting sequence number.

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • No Video

Audio codecs

  • MP2 (MPEG audio layer 2)
  • No Audio

RTP (Pro-MPEG)

Configuration Parameter: rtp_mpegts

Extensions:

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • No Video

Audio codecs

  • MP2 (MPEG audio layer 2)
  • AAC (Advanced Audio Coding)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • No Audio

Pro-MPEG Code of Practice #3 Release 2 FEC protocol.

The Pro-MPEG CoP#3 FEC is a 2D parity-check forward error correction mechanism for MPEG-2 Transport Streams sent over RTP. This protocol must be used in conjunction with the rtp_mpegts muxer and the rtp protocol.

The required syntax is:

-f rtp_mpegts -fec prompeg=option=val... rtp://hostname:port

The destination UDP ports are port + 2 for the column FEC stream and port + 4 for the row FEC stream.

This protocol accepts the following options:

Name Type Default Description
l int 8 The number of columns (4-20, LxD Lsss 100)
d int 4 The number of rows (4-20, LxD Less 100)

RTSP Streaming (beta)

Configuration Parameter: rtsp

Extensions: rtsp://

Additional attributes

Name Type Default Description
split_channels option_fixed 0 Split the overall audio channel into individual audio tracks, where each track contains a specific number of channels specified by the split_channels property
For example, if you record an input source with 12 audio channels and split_channels='4', you will get 3 audio tracks, each containing 4 audio channels.
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
rtpflags flags   RTP muxer flags
  • latm - Use MP4A-LATM packetization instead of MPEG4-GENERIC for AAC
  • rfc2190 - Use RFC 2190 packetization instead of RFC 4629 for H.263
  • skip_rtcp - Don't send RTCP sender reports
  • h264_mode0 - Use mode 0 for H.264 in RTP
  • send_bye - Send RTCP BYE packets when finishing
rtsp_transport flags  

Set RTSP transport protocols. It accepts the following values:

  • ‘udp’ - Use UDP as lower transport protocol.
  • ‘tcp’ - Use TCP (interleaving within the RTSP control channel) as lower transport protocol.
  • ‘udp_multicast’ - Use UDP multicast as lower transport protocol.
  • ‘http’ - Use HTTP tunneling as lower transport protocol, which is useful for passing proxies.
  • ‘https’ - Use HTTPs tunneling as lower transport protocol, which is useful for passing proxies and widely used for security consideration.

Multiple lower transport protocols may be specified, in that case they are tried one at a time (if the setup of one fails, the next one is tried). For the muxer, only the ‘tcp’ and ‘udp’ options are supported.
rtsp_flags flags none

Set RTSP flags. The following values are accepted:

  • ‘filter_src’ - Accept packets only from negotiated peer address and port.
  • ‘listen’ - Act as a server, listening for an incoming connection.
  • ‘prefer_tcp’ - Try TCP for RTP transport first, if TCP is available as RTSP RTP transport.
  • ‘satip_raw’ - Export raw MPEG-TS stream instead of demuxing. The flag will simply write out the raw stream, with the original PAT/PMT/PIDs intact.

Default value is ‘none’.
min_port int 5000 Set minimum local UDP port. Default value is 5000.
max_port int 65000 Set maximum local UDP port. Default value is 65000.
buffer_size int -1 Underlying protocol send/receive buffer size in bytes.

Video codecs

  • Cisco OpenH264 Encoder
  • H.264 / MPEG-4 AVC
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • No Audio

IIS Live Smooth Streaming

Configuration Parameter: ismv

Extensions: http://

Video codecs

  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • VC-1
  • Direct stream copy
  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)
  • Direct stream copy

Apple HTTP Live Streaming

Configuration Parameter: hls

Extensions: m3u8

Additional attributes

Name Type Default Description
embed_cc bool false Enable embedding Closed Captions (ATSC) into elementary video stream.
embed_scte35 bool false Enable embedding SCTE-35 triggers into HLS stream.
start_number int64 0 Start the playlist sequence number (#EXT-X-MEDIA-SEQUENCE) from the specified number when hls_start_number_source value is generic. (This is the default case.) Unless hls_flags single_file is set, it also specifies starting sequence numbers of segment and subtitle filenames. Default value is 0.
hls_time double 2.000000 Set the target segment length. Default value is 2. Вuration must be a time duration specification. Segment will be cut on the next key frame after this time has passed.
hls_init_time double 0.000000 Set the initial target segment length. Default value is 0. Duration must be a time duration specification. Segment will be cut on the next key frame after this time has passed on the first m3u8 list. After the initial playlist is filled, ffmpeg will cut segments at duration equal to hls_time.
hls_list_size int 5 Set the maximum number of playlist entries. If set to 0 the list file will contain all the segments. Default value is 5.
hls_delete_threshold int 1 Set the number of unreferenced segments to keep on disk before hls_flags delete_segments deletes them. Increase this to allow continue clients to download segments which were recently referenced in the playlist. Default value is 1, meaning segments older than hls_list_size+1 will be deleted.
hls_ts_options string   Set hls mpegts list of options for the container format used for HLS.
hls_vtt_options string   Set hls vtt list of options for the container format used for HLS.
hls_wrap int 0 Set number after which the index wraps (will be deprecated).
hls_allow_cache int -1 Explicitly set whether the client MAY (1) or MUST NOT (0) cache media segments.
hls_base_url string   Append baseurl to every entry in the playlist. Useful to generate playlists with absolute paths. Note that the playlist sequence number must be unique for each segment and it is not to be confused with the segment filename sequence number which can be cyclic, for example if the wrap option is specified.
hls_segment_filename string   Set the segment filename. Unless the hls_flags option is set with ‘single_file’, filename is used as a string format with the segment number appended.
hls_segment_size int 0 maximum size per segment file, (in bytes).
hls_key_info_file string  

Use the information in key_info_file for segment encryption. The first line of key_info_file specifies the key URI written to the playlist. The key URL is used to access the encryption key during playback. The second line specifies the path to the key file used to obtain the key during the encryption process. The key file is read as a single packed array of 16 octets in binary format. The optional third line specifies the initialization vector (IV) as a hexadecimal string to be used instead of the segment sequence number (default) for encryption. Changes to key_info_file will result in segment encryption with the new key/IV and an entry in the playlist for the new key URI/IV if hls_flags periodic_rekey is enabled.

Key info file format:

key URI
key file path
IV (optional)

Example key URIs:

http://server/file.key
/path/to/file.key
file.key

Example key file paths:

file.key
/path/to/file.key

Example IV:

0123456789ABCDEF0123456789ABCDEF

Key info file example:

http://server/file.key
/path/to/file.key
0123456789ABCDEF0123456789ABCDEF
hls_enc     Enable (1) or disable (0) the AES128 encryption. When enabled every segment generated is encrypted and the encryption key is saved as playlist name.key.
hls_enc_key string   Specify a 16-octet key to encrypt the segments, by default it is randomly generated.
hls_enc_key_url string   If set, keyurl is prepended instead of baseurl to the key filename in the playlist.
hls_enc_iv string   Specify the 16-octet initialization vector for every segment instead of the autogenerated ones.
hls_subtitle_path string   Set path of hls subtitles
hls_segment_type option mpegts Set hls segment files type
segment_type    
  • mpegts - Output segment files in MPEG-2 Transport Stream format. This is compatible with all HLS versions
  • fmp4 - Output segment files in fragmented MP4 format, similar to MPEG-DASH. fmp4 files may be used in HLS version 7 and above
hls_fmp4_init_filename string init.mp4 Set filename for the fragment files header file, default filename is init.mp4. When strftime is enabled, filename is expanded to the segment filename with localtime.
hls_flags flags   Set flags affecting HLS playlist and media file generation
flags    
  • temp_file - write segment to temporary file and rename when complete
  • delete_segments - delete segment files that are no longer part of the playlist
  • round_durations - round durations in m3u8 to whole numbers
  • discont_start - start the playlist with a discontinuity tag
  • omit_endlist - Do not append an endlist when ending stream
  • split_by_time - split the hls segment by time which user set by hls_time
  • append_list - append the new segments into old hls segment list
  • program_date_time - add EXT-X-PROGRAM-DATE-TIME
  • second_level_segment_index - include segment index in segment filenames when use_localtime
  • second_level_segment_duration - include segment duration in segment filenames when use_localtime
  • second_level_segment_size - include segment size in segment filenames when use_localtime
  • periodic_rekey - reload keyinfo file periodically for re-keying
  • independent_segments - add EXT-X-INDEPENDENT-SEGMENTS, whenever applicable
use_localtime     Set filename expansion with strftime at segment creation.
use_localtime_mkdir     Create last directory component in strftime-generated filename.
hls_playlist_type option   Set the HLS playlist type.
pl_type    
  • vod - If type is ‘vod’, emit #EXT-X-PLAYLIST-TYPE:VOD in the m3u8 header. This forces hls_list_size to 0; the playlist must not change.
  • event - If type is ‘event’, emit #EXT-X-PLAYLIST-TYPE:EVENT in the m3u8 header. This forces hls_list_size to 0; the playlist can only be appended to.
method string   Use the given HTTP method to create the hls files (default: PUT)
hls_start_number_source option generic Start the playlist sequence number (#EXT-X-MEDIA-SEQUENCE) according to the specified source. Unless hls_flags single_file is set, it also specifies source of starting sequence numbers of segment and subtitle filenames. In any case, if hls_flags append_list is set and read playlist sequence number is greater than the specified start sequence number, then that value will be used as start value.
start_sequence_source_type    
  • epoch - seconds since epoch
  • datetime - current datetime as YYYYMMDDhhmmss
http_user_agent string   Override User-Agent field in HTTP header. Applicable only for HTTP output.
var_stream_map string   Specify a map string defining how to group the audio, video and subtitle streams into different variant streams. The variant stream groups are separated by space. Expected string format is like this "a:0,v:0 a:1,v:1 ....". Here a:, v:, s: are the keys to specify audio, video and subtitle streams respectively. Allowed values are 0 to 9 (limited just based on practical usage).
cc_stream_map string   Map string which specifies different closed captions groups and their attributes. The closed captions stream groups are separated by space. Expected string format is like this "ccgroup:<group name>, instreamid:<INSTREAM-ID>, language:<language code> ....". ’ccgroup’ and ’instreamid’ are mandatory attributes. ’language’ is an optional attribute. The closed captions groups configured using this option are mapped to different variant streams by providing the same ’ccgroup’ name in the var_stream_map string.
master_pl_name string   Create HLS master playlist with the given name.
master_pl_publish_rate int 0 Publish master play list repeatedly every after specified number of segment intervals.
http_persistent     Use persistent HTTP connections. Applicable only for HTTP output.
timeout     Set timeout for socket I/O operations. Applicable only for HTTP output.

Video codecs

  • MPEG-2 Video
  • MPEG-4 part 2 Video
  • libx264 H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
  • Cisco OpenH264 Encoder
  • Intel QuickSync SW H.264 Encoder
  • Intel QuickSync HW H.264 Encoder
  • Intel QuickSync HEVC Encoder
  • NVIDIA NVEnc H.264 Encoder
  • NVIDIA NVEnc H.264 Lossless Encoder
  • NVIDIA NVEnc H.265 (HEVC) Encoder
  • AMD AMF H.264 Encoder
  • AMD AMF H.265 (HEVC) Encoder
  • x265 H.265/HEVC
  • Direct stream copy
  • No Video

Audio codecs

  • MP2 (MPEG audio layer 2)
  • AAC (Advanced Audio Coding)
  • MP3 Lame (MPEG audio layer 3)
  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed
  • Direct stream copy
  • No Audio

Icecast Streaming

Configuration Parameter: icecast

Extensions:

Additional attributes

Name Type Default Description
ice_genre string   Set the stream genre.
ice_name string   Set the stream name.
ice_description string   Set the stream description.
ice_url string   Set the stream website URL.
ice_public bool false Set if the stream should be public. The default is false (not public).

user_agent

 string   Override the User-Agent header. If not specified a string of the form "Lavf/<version>" will be used.

password

 string   Set the Icecast mountpoint password.

content_type

 string   Set the stream content type. This must be set if it is different from audio/mpeg.

legacy_icecast

 bool   This enables support for Icecast versions less 2.4.0, that do not support the HTTP PUT method but the SOURCE method.

tls

 bool false Establish a TLS (HTTPS) connection to Icecast.

metadata_update_url

 string false Set the Icecast metadata update http-query string.

Video codecs

  • No Video

Audio codecs

  • Ogg Vorbis
  • FLAC (Free Lossless Audio Codec)
  • AAC (Advanced Audio Coding)
  • MP3 Lame (MPEG audio layer 3)
  • No Audio

Image Sequence

Configuration Parameter: image2

Extensions: dpx,png,jpg,tiff,tga,j2c

Additional attributes

Name Type Default Description
create_folder bool true Create folder for image sequence

Video codecs

  • DPX Codec
  • PNG Codec
  • JPG Codec

Audio codecs

  • No Audio
  • WAV (Wave Audio File)

MP3 (MPEG audio layer 3)

Configuration Parameter: mp3

Extensions: mp3

Additional attributes

Name Type Default Description
id3v2_version int 4 Select ID3v2 version to write. Currently 3 and 4 are supported.
write_id3v1 int 0 Enable ID3v1 writing. ID3v1 tags are written in UTF-8 which may not be supported by most software.

Video codecs

  • No Video

Audio codecs

  • MP3 Lame (MPEG audio layer 3)

AC3 (AC3 audio files)

Configuration Parameter: ac3

Extensions: ac3

Video codecs

  • No Video

Audio codecs

  • ATSC A/52A (AC-3)
  • ATSC A/52A (AC-3) Fixed

AAC (Advanced Audio Codec)

Configuration Parameter: adts

Extensions: aac

Video codecs

  • No Video

Audio codecs

  • AAC (Advanced Audio Coding)

WAV (Wave Audio Files)

Configuration Parameter: wav

Extensions: wav

Video codecs

  • No Video

Audio codecs

  • (Uncompressed) PCM signed 16-bit little-endian
  • (Uncompressed) PCM 32-bit floating point little-endian
  • (Uncompressed) PCM D-Cinema audio signed 24-bit
  • (Uncompressed) PCM signed 24-bit little-endian
  • (Uncompressed) PCM signed 32-bit little-endian

Ogg

Configuration Parameter: ogg

Extensions: ogg

Video codecs

  • No Video

Audio codecs

  • Vorbis
Was this article helpful?
0 out of 0 found this helpful
Return to top

Related articles