2018-02-10 23:37:42 +00:00
2020-01-22 00:59:16 +00:00
<!DOCTYPE html>
2017-09-20 02:35:05 +00:00
< html xmlns = "http://www.w3.org/1999/xhtml" >
< head >
2020-01-22 00:59:16 +00:00
< meta charset = "utf-8" / >
2017-09-20 02:35:05 +00:00
< title > Packager Documentation — Shaka Packager documentation< / title >
< link rel = "stylesheet" href = "_static/sphinxdoc_new.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/pygments.css" type = "text/css" / >
2020-01-22 00:59:16 +00:00
< link rel = "stylesheet" type = "text/css" href = "_static/graphviz.css" / >
< link rel = "stylesheet" type = "text/css" href = "_static/table_styling.css" / >
< script type = "text/javascript" id = "documentation_options" data-url_root = "./" src = "_static/documentation_options.js" > < / script >
2017-09-20 02:35:05 +00:00
< script type = "text/javascript" src = "_static/jquery.js" > < / script >
< script type = "text/javascript" src = "_static/underscore.js" > < / script >
< script type = "text/javascript" src = "_static/doctools.js" > < / script >
2020-01-22 00:59:16 +00:00
< script type = "text/javascript" src = "_static/language_data.js" > < / script >
2017-09-20 02:35:05 +00:00
< link rel = "index" title = "Index" href = "genindex.html" / >
< link rel = "search" title = "Search" href = "search.html" / >
< link rel = "next" title = "Tutorials" href = "tutorials/tutorials.html" / >
< link rel = "prev" title = "Welcome to Shaka Packager’ href = "index.html" / >
2020-01-22 00:59:16 +00:00
< / head > < body >
2017-09-20 02:35:05 +00:00
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "genindex.html" title = "General Index"
accesskey="I">index< / a > < / li >
< li class = "right" >
< a href = "tutorials/tutorials.html" title = "Tutorials"
accesskey="N">next< / a > |< / li >
< li class = "right" >
< a href = "index.html" title = "Welcome to Shaka Packager’
accesskey="P">previous< / a > |< / li >
< li class = "nav-item nav-item-0" > < a href = "index.html" > Shaka Packager documentation< / a > » < / li >
< / ul >
< / div >
< div class = "sphinxsidebar" role = "navigation" aria-label = "main navigation" >
< div class = "sphinxsidebarwrapper" >
2020-01-22 00:59:16 +00:00
< h3 > < a href = "index.html" > Table of Contents< / a > < / h3 >
2017-09-20 02:35:05 +00:00
< ul >
< li > < a class = "reference internal" href = "#" > Packager Documentation< / a > < ul >
< li > < a class = "reference internal" href = "#getting-shaka-packager" > Getting Shaka Packager< / a > < / li >
< li > < a class = "reference internal" href = "#synopsis" > Synopsis< / a > < ul >
< li > < a class = "reference internal" href = "#stream-descriptors" > Stream descriptors< / a > < / li >
2017-10-24 22:51:02 +00:00
< li > < a class = "reference internal" href = "#drm-related-stream-descriptor-fields" > DRM related Stream descriptor fields< / a > < / li >
2018-12-20 22:38:40 +00:00
< li > < a class = "reference internal" href = "#dash-specific-stream-descriptor-fields" > DASH specific stream descriptor fields< / a > < / li >
2017-09-20 02:35:05 +00:00
< li > < a class = "reference internal" href = "#hls-specific-stream-descriptor-fields" > HLS specific stream descriptor fields< / a > < / li >
< li > < a class = "reference internal" href = "#chunking-options" > Chunking options< / a > < / li >
< li > < a class = "reference internal" href = "#mp4-output-options" > MP4 output options< / a > < / li >
2018-08-16 00:35:22 +00:00
< li > < a class = "reference internal" href = "#transport-stream-output-options" > Transport stream output options< / a > < / li >
2017-09-20 02:35:05 +00:00
< li > < a class = "reference internal" href = "#dash-options" > DASH options< / a > < / li >
< li > < a class = "reference internal" href = "#hls-options" > HLS options< / a > < / li >
2018-08-16 00:35:22 +00:00
< li > < a class = "reference internal" href = "#ads-options" > Ads options< / a > < / li >
2017-09-20 02:35:05 +00:00
< / ul >
< / li >
< li > < a class = "reference internal" href = "#encryption-decryption-options" > Encryption / decryption options< / a > < ul >
< li > < a class = "reference internal" href = "#general-encryption-options" > General encryption options< / a > < / li >
< li > < a class = "reference internal" href = "#raw-key-encryption-options" > Raw key encryption options< / a > < / li >
< li > < a class = "reference internal" href = "#widevine-encryption-options" > Widevine encryption options< / a > < / li >
2018-05-23 23:12:00 +00:00
< li > < a class = "reference internal" href = "#playready-encryption-options" > PlayReady encryption options< / a > < / li >
2017-09-20 02:35:05 +00:00
< / ul >
< / li >
< / ul >
< / li >
< / ul >
< h4 > Previous topic< / h4 >
< p class = "topless" > < a href = "index.html"
2018-02-10 23:37:42 +00:00
title="previous chapter">Welcome to Shaka Packager’ < / a > < / p >
2017-09-20 02:35:05 +00:00
< h4 > Next topic< / h4 >
< p class = "topless" > < a href = "tutorials/tutorials.html"
title="next chapter">Tutorials< / a > < / p >
< div role = "note" aria-label = "source link" >
< h3 > This Page< / h3 >
< ul class = "this-page-menu" >
< li > < a href = "_sources/documentation.rst.txt"
rel="nofollow">Show Source< / a > < / li >
< / ul >
< / div >
< div id = "searchbox" style = "display: none" role = "search" >
2020-01-22 00:59:16 +00:00
< h3 id = "searchlabel" > Quick search< / h3 >
< div class = "searchformwrapper" >
2017-09-20 02:35:05 +00:00
< form class = "search" action = "search.html" method = "get" >
2020-01-22 00:59:16 +00:00
< input type = "text" name = "q" aria-labelledby = "searchlabel" / >
< input type = "submit" value = "Go" / >
2017-09-20 02:35:05 +00:00
< / form >
2020-01-22 00:59:16 +00:00
< / div >
2017-09-20 02:35:05 +00:00
< / div >
< script type = "text/javascript" > $ ( '#searchbox' ) . show ( 0 ) ; < / script >
< / div >
< / div >
< div class = "document" >
< div class = "documentwrapper" >
< div class = "bodywrapper" >
< div class = "body" role = "main" >
< div class = "section" id = "packager-documentation" >
< h1 > Packager Documentation< a class = "headerlink" href = "#packager-documentation" title = "Permalink to this headline" > ¶< / a > < / h1 >
< p > Shaka Packager is a tool and a media packaging SDK for DASH and HLS packaging
and encryption. It can transmux input media files from one container to another
container.< / p >
< div class = "admonition note" >
2020-01-22 00:59:16 +00:00
< p class = "admonition-title" > Note< / p >
< p > Shaka Packager does not do transcoding. Content must be pre-encoded before
2017-09-20 02:35:05 +00:00
passing to packager.< / p >
< / div >
< p > Packager operates in < em > streams< / em > , described by < em > stream_descriptor< / em > . The streams
2018-02-10 23:37:42 +00:00
can be read from the same “file” or different “files”, which can be regular
2017-09-20 02:35:05 +00:00
files, pipes, udp streams, etc.< / p >
< p > This page is the documentation on using the < em > packager< / em > tool. If you are
interested in integrating < em > packager< / em > library into your own tool, please see
< a class = "reference internal" href = "library.html" > < span class = "doc" > Shaka Packager Library< / span > < / a > .< / p >
< div class = "section" id = "getting-shaka-packager" >
< h2 > Getting Shaka Packager< a class = "headerlink" href = "#getting-shaka-packager" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > There are several ways you can get Shaka Packager.< / p >
< ul class = "simple" >
2020-01-22 00:59:16 +00:00
< li > < p > Using < a class = "reference external" href = "https://www.docker.com/whatisdocker" > Docker< / a > .
Instructions are available at < a class = "reference internal" href = "docker_instructions.html" > < span class = "doc" > Using Docker< / span > < / a > .< / p > < / li >
< li > < p > Get prebuilt binaries from
< a class = "reference external" href = "https://github.com/google/shaka-packager/releases" > release< / a > .< / p > < / li >
< li > < p > Built from source, see < a class = "reference internal" href = "build_instructions.html" > < span class = "doc" > Build Instructions< / span > < / a > for details.< / p > < / li >
2017-09-20 02:35:05 +00:00
< / ul >
< / div >
< div class = "section" id = "synopsis" >
< h2 > Synopsis< a class = "headerlink" href = "#synopsis" title = "Permalink to this headline" > ¶< / a > < / h2 >
2020-01-22 00:59:16 +00:00
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > $ packager < stream_descriptor> ... \
2017-09-20 02:35:05 +00:00
[--dump_stream_info] \
2020-01-22 00:59:16 +00:00
[--quiet] \
2017-09-20 02:35:05 +00:00
[Chunking Options] \
[MP4 Output Options] \
[encryption / decryption options] \
[DASH options] \
2018-08-16 00:35:22 +00:00
[HLS options] \
[Ads options]
2017-09-20 02:35:05 +00:00
< / pre > < / div >
< / div >
< div class = "section" id = "stream-descriptors" >
< h3 > Stream descriptors< a class = "headerlink" href = "#stream-descriptors" title = "Permalink to this headline" > ¶< / a > < / h3 >
2018-02-10 23:37:42 +00:00
< p > There can be multiple < em > stream_descriptor< / em > with input from the same “file” or
multiple different “files”.< / p >
2017-10-24 22:51:02 +00:00
< p > Stream descriptor is of the form:< / p >
2020-01-22 00:59:16 +00:00
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "o" > < < / span > < span class = "n" > field< / span > < span class = "o" > > =< < / span > < span class = "n" > value< / span > < span class = "o" > > < / span > < span class = "p" > [,< / span > < span class = "o" > < < / span > < span class = "n" > field< / span > < span class = "o" > > =< < / span > < span class = "n" > value< / span > < span class = "o" > > < / span > < span class = "p" > ]< / span > < span class = "o" > ...< / span >
2017-09-20 02:35:05 +00:00
< / pre > < / div >
< / div >
< p > These are the available fields:< / p >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > input (in)< / dt >
< dd class = "field-odd" > < p > input/source media “file” path, which can be regular files, pipes, udp
2017-09-20 02:35:05 +00:00
streams. See < a class = "reference internal" href = "options/udp_file_options.html" > < span class = "doc" > UDP file options< / span > < / a > on additional options for UDP
2020-01-22 00:59:16 +00:00
files.< / p >
< / dd >
< dt class = "field-even" > stream_selector (stream)< / dt >
< dd class = "field-even" > < p > Required field with value ‘ ’ ‘ ’ ‘ ’
based).< / p >
< / dd >
< dt class = "field-odd" > output (out)< / dt >
< dd class = "field-odd" > < p > Required output file path (single file).< / p >
< / dd >
< dt class = "field-even" > init_segment< / dt >
< dd class = "field-even" > < p > initialization segment path (multiple file).< / p >
< / dd >
< dt class = "field-odd" > segment_template (segment)< / dt >
< dd class = "field-odd" > < p > Optional value which specifies the naming pattern for the segment files,
2017-09-20 02:35:05 +00:00
and that the stream should be split into multiple files. Its presence should
be consistent across streams. See
2020-01-22 00:59:16 +00:00
< a class = "reference internal" href = "options/segment_template_formatting.html" > < span class = "doc" > Segment template formatting< / span > < / a > .< / p >
< / dd >
< dt class = "field-even" > bandwidth (bw)< / dt >
< dd class = "field-even" > < p > Optional value which contains a user-specified maximum bit rate for the
2017-09-20 02:35:05 +00:00
stream, in bits/sec. If specified, this value is propagated to (HLS)
EXT-X-STREAM-INF:BANDWIDTH or (DASH) Representation@ bandwidth and the
$Bandwidth$ template parameter for segment names. If not specified, the
bandwidth value is estimated from content bitrate. Note that it only affects
the generated manifests/playlists; it has no effect on the media content
2020-01-22 00:59:16 +00:00
itself.< / p >
< / dd >
< dt class = "field-odd" > language (lang)< / dt >
< dd class = "field-odd" > < p > Optional value which contains a user-specified language tag. If specified,
this value overrides any language metadata in the input stream.< / p >
< / dd >
< dt class = "field-even" > output_format (format)< / dt >
< dd class = "field-even" > < p > Optional value which specifies the format of the output files (MP4 or WebM).
2017-09-20 02:35:05 +00:00
If not specified, it will be derived from the file extension of the output
2020-01-22 00:59:16 +00:00
file.< / p >
< / dd >
< dt class = "field-odd" > trick_play_factor (tpf)< / dt >
< dd class = "field-odd" > < p > Optional value which specifies the trick play, a.k.a. trick mode, stream
2017-10-24 22:51:02 +00:00
sampling rate among key frames. If specified, the output is a trick play
2020-01-22 00:59:16 +00:00
stream.< / p >
< / dd >
< / dl >
2017-10-24 22:51:02 +00:00
< / div >
< div class = "section" id = "drm-related-stream-descriptor-fields" >
< h3 > DRM related Stream descriptor fields< a class = "headerlink" href = "#drm-related-stream-descriptor-fields" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > skip_encryption=0|1< / dt >
< dd class = "field-odd" > < p > Optional. Defaults to 0 if not specified. If it is set to 1, no encryption
of the stream will be made.< / p >
< / dd >
< dt class = "field-even" > drm_label< / dt >
< dd class = "field-even" > < p > Optional value for custom DRM label, which defines the encryption key
2017-10-24 22:51:02 +00:00
applied to the stream. Typically values include AUDIO, SD, HD, UHD1, UHD2.
2018-02-10 23:37:42 +00:00
For raw key, it should be a label defined in –
2017-10-24 22:51:02 +00:00
DRM label is derived from stream type (video, audio), resolutions, etc.
2020-01-22 00:59:16 +00:00
Note that it is case sensitive.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
2018-12-20 22:38:40 +00:00
< div class = "section" id = "dash-specific-stream-descriptor-fields" >
< h3 > DASH specific stream descriptor fields< a class = "headerlink" href = "#dash-specific-stream-descriptor-fields" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > dash_accessibilities (accessibilities)< / dt >
< dd class = "field-odd" > < p > Optional semicolon separated list of values for DASH Accessibility element.
The value should be in the format: scheme_id_uri=value, which propagates
to the Accessibility element in the result DASH manifest. See DASH
(ISO/IEC 23009-1) specification for details.< / p >
< / dd >
< dt class = "field-even" > dash_roles (roles)< / dt >
< dd class = "field-even" > < p > Optional semicolon separated list of values for DASH Role element. The
value should be one of: < strong > caption< / strong > , < strong > subtitle< / strong > , < strong > main< / strong > , < strong > alternate< / strong > ,
< strong > supplementary< / strong > , < strong > commentary< / strong > and < strong > dub< / strong > . See DASH (ISO/IEC 23009-1)
specification for details.< / p >
< / dd >
< / dl >
2018-12-20 22:38:40 +00:00
< / div >
2017-09-20 02:35:05 +00:00
< div class = "section" id = "hls-specific-stream-descriptor-fields" >
< h3 > HLS specific stream descriptor fields< a class = "headerlink" href = "#hls-specific-stream-descriptor-fields" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "field-list simple" >
< dt class = "field-odd" > hls_name< / dt >
< dd class = "field-odd" > < p > Used for HLS audio to set the NAME attribute for EXT-X-MEDIA.
Defaults to the base of the playlist name.< / p >
< / dd >
< dt class = "field-even" > hls_group_id< / dt >
< dd class = "field-even" > < p > Used for HLS audio to set the GROUP-ID attribute for EXT-X-MEDIA.
Defaults to ‘ ’ < / p >
< / dd >
< dt class = "field-odd" > playlist_name< / dt >
< dd class = "field-odd" > < p > The HLS playlist file to create. Usually ends with ‘ ’
2018-02-10 23:37:42 +00:00
relative to hls_master_playlist_output (see below). If unspecified,
defaults to something of the form ‘ ’ ‘ ’
2020-01-22 00:59:16 +00:00
‘ ’ < / p >
< / dd >
< dt class = "field-even" > iframe_playlist_name< / dt >
< dd class = "field-even" > < p > The optional HLS I-Frames only playlist file to create. Usually ends with
2018-02-10 23:37:42 +00:00
‘ ’
only be set for video streams. If unspecified, no I-Frames only playlist is
2020-01-22 00:59:16 +00:00
created.< / p >
< / dd >
< dt class = "field-odd" > hls_characteristics (charcs)< / dt >
< dd class = "field-odd" > < p > Optional colon or semi-colon separated list of values for the
2018-12-20 22:38:40 +00:00
CHARACTERISTICS attribute for EXT-X-MEDIA. See CHARACTERISTICS attribute in
2020-01-22 00:59:16 +00:00
< a class = "reference external" href = "http://bit.ly/2OOUkdB" > http://bit.ly/2OOUkdB< / a > for details.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "chunking-options" >
< h3 > Chunking options< a class = "headerlink" href = "#chunking-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --segment_duration < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Segment duration in seconds. If single_segment is specified, this parameter
2017-09-20 02:35:05 +00:00
sets the duration of a subsegment; otherwise, this parameter sets the
duration of a segment. Actual segment durations may not be exactly as
2020-01-22 00:59:16 +00:00
requested.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --fragment_duration < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Fragment duration in seconds. Should not be larger than the segment
duration. Actual fragment durations may not be exactly as requested.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --segment_sap_aligned< / span > < / kbd > < / dt >
< dd > < p > Force segments to begin with stream access points. Default enabled.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --fragment_sap_aligned< / span > < / kbd > < / dt >
< dd > < p > Force fragments to begin with stream access points. This flag implies
< em > segment_sap_aligned< / em > . Default enabled.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "mp4-output-options" >
< h3 > MP4 output options< a class = "headerlink" href = "#mp4-output-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --mp4_include_pssh_in_stream< / span > < / kbd > < / dt >
< dd > < p > MP4 only: include pssh in the encrypted stream. Default enabled.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --mp4_use_decoding_timestamp_in_timeline< / span > < / kbd > < / dt >
< dd > < p > Deprecated. Do not use.< / p >
< / dd >
< / dl >
2018-08-16 00:35:22 +00:00
< p > –
– < / p >
< blockquote >
2020-01-22 00:59:16 +00:00
< div > < p > For MP4 with DASH live profile only: Indicates whether to generate ‘ ’
2018-08-16 00:35:22 +00:00
box in media segments. Note that it is reuqired by spec if segment template
2020-01-22 00:59:16 +00:00
contains $Time$ specifier.< / p >
< / div > < / blockquote >
2018-08-16 00:35:22 +00:00
< / div >
< div class = "section" id = "transport-stream-output-options" >
< h3 > Transport stream output options< a class = "headerlink" href = "#transport-stream-output-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --transport_stream_timestamp_offset_ms< / span > < / kbd > < / dt >
< dd > < p > Transport stream only (MPEG2-TS, HLS Packed Audio): A positive value, in
2018-08-16 00:35:22 +00:00
milliseconds, by which output timestamps are offset to compensate for
possible negative timestamps in the input. For example, timestamps from
ISO-BMFF after adjusted by EditList could be negative. In transport streams,
2020-01-22 00:59:16 +00:00
timestamps are not allowed to be less than zero. Default: 100ms.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "dash-options" >
< h3 > DASH options< a class = "headerlink" href = "#dash-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --generate_static_live_mpd< / span > < / kbd > < / dt >
< dd > < p > If enabled, generates static mpd. If segment_template is specified in
2017-09-20 02:35:05 +00:00
stream descriptors, shaka-packager generates dynamic mpd by default; if
this flag is enabled, shaka-packager generates static mpd instead. Note
that if segment_template is not specified, shaka-packager always generates
2020-01-22 00:59:16 +00:00
static mpd regardless of the value of this flag.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --mpd_output < var > < file_path> < / var > < / span > < / kbd > < / dt >
< dd > < p > MPD output file name.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --base_urls < var > < comma_separated_urls> < / var > < / span > < / kbd > < / dt >
< dd > < dl class = "simple" >
< dt > Comma separated BaseURLs for the MPD:< / dt > < dd > < p > < strong > < url> [,< url> ]…< / strong > .< / p >
< / dd >
2018-05-23 23:12:00 +00:00
< / dl >
2020-01-22 00:59:16 +00:00
< p > The values will be added as < BaseURL> element(s) immediately under the < MPD>
2018-05-23 23:12:00 +00:00
element.< / p >
2020-01-22 00:59:16 +00:00
< / dd >
< dt > < kbd > < span class = "option" > --min_buffer_time < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Specifies, in seconds, a common duration used in the definition of the MPD
Representation data rate.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --minimum_update_period < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Indicates to the player how often to refresh the media presentation
description in seconds. This value is used for dynamic MPD only.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --suggested_presentation_delay < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Specifies a delay, in seconds, to be added to the media presentation time.
This value is used for dynamic MPD only.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --time_shift_buffer_depth < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Guaranteed duration of the time shifting buffer for dynamic media
presentations, in seconds.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --preserved_segments_outside_live_window < var > < num_segments> < / var > < / span > < / kbd > < / dt >
< dd > < p > Segments outside the live window (defined by < cite > time_shift_buffer_depth< / cite >
2018-05-23 23:12:00 +00:00
above) are automatically removed except for the most recent X segments
defined by this parameter. This is needed to accommodate latencies in
various stages of content serving pipeline, so that the segments stay
accessible as they may still be accessed by the player.< / p >
2020-01-22 00:59:16 +00:00
< p > The segments are not removed if the value is zero.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --utc_timings < var > < scheme_id_uri_value_pairs> < / var > < / span > < / kbd > < / dt >
< dd > < dl class = "simple" >
< dt > Comma separated UTCTiming schemeIdUri and value pairs for the MPD:< / dt > < dd > < p > < strong > < scheme_id_uri> =< value> [,< scheme_id_uri> =< value> ]…< / strong > < / p >
< / dd >
2018-05-23 23:12:00 +00:00
< / dl >
2020-01-22 00:59:16 +00:00
< p > This value is used for dynamic MPD only.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --default_language < var > < language> < / var > < / span > < / kbd > < / dt >
< dd > < p > Any audio/text tracks tagged with this language will have
2018-02-10 23:37:42 +00:00
< Role … value=”main” /> in the manifest. This allows the player to
2018-12-20 22:38:40 +00:00
choose the correct default language for the content.< / p >
2020-01-22 00:59:16 +00:00
< p > This applies to both audio and text tracks. The default language for text
2018-12-20 22:38:40 +00:00
tracks can be overriden by ‘ ’ < / p >
2020-01-22 00:59:16 +00:00
< / dd >
< dt > < kbd > < span class = "option" > --default_text_language < var > < text_language> < / var > < / span > < / kbd > < / dt >
< dd > < p > Same as above, but this applies to text tracks only, and overrides the
default language for text tracks.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --allow_approximate_segment_timeline< / span > < / kbd > < / dt >
< dd > < p > For live profile only.< / p >
2018-05-23 23:12:00 +00:00
< p > If enabled, segments with close duration (i.e. with difference less than
one sample) are considered to have the same duration. This enables
MPD generator to generate less SegmentTimeline entries. If all segments
are of the same duration except the last one, we will do further
optimization to use < a class = "reference external" href = "mailto:SegmentTemplate%40duration" > SegmentTemplate< span > @ < / span > duration< / a > instead and omit
SegmentTimeline completely.< / p >
2020-01-22 00:59:16 +00:00
< p > Ignored if $Time$ is used in segment template, since $Time$ requires
2018-05-23 23:12:00 +00:00
accurate Segment Timeline.< / p >
2020-01-22 00:59:16 +00:00
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "hls-options" >
< h3 > HLS options< a class = "headerlink" href = "#hls-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --hls_master_playlist_output < var > < file_path> < / var > < / span > < / kbd > < / dt >
< dd > < p > Output path for the master playlist for HLS. This flag must be used to
output HLS.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --hls_base_url < var > < url> < / var > < / span > < / kbd > < / dt >
< dd > < p > The base URL for the Media Playlists and media files listed in the
playlists. This is the prefix for the files.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --hls_key_uri < var > < uri> < / var > < / span > < / kbd > < / dt >
< dd > < p > The key uri for ‘ ’ ‘ ’
2018-08-16 00:35:22 +00:00
key formats. Ignored if the playlist is not encrypted or not using the above
2020-01-22 00:59:16 +00:00
key formats.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --hls_playlist_type < var > < type> < / var > < / span > < / kbd > < / dt >
< dd > < p > VOD, EVENT, or LIVE. This defines the EXT-X-PLAYLIST-TYPE in the HLS
2017-09-20 02:35:05 +00:00
specification. For hls_playlist_type of LIVE, EXT-X-PLAYLIST-TYPE tag is
2020-01-22 00:59:16 +00:00
omitted.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --time_shift_buffer_depth < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Guaranteed duration of the time shifting buffer for LIVE playlists, in
seconds.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --preserved_segments_outside_live_window < var > < num_segments> < / var > < / span > < / kbd > < / dt >
< dd > < p > Segments outside the live window (defined by < cite > time_shift_buffer_depth< / cite >
2018-05-23 23:12:00 +00:00
above) are automatically removed except for the most recent X segments
defined by this parameter. This is needed to accommodate latencies in
various stages of content serving pipeline, so that the segments stay
accessible as they may still be accessed by the player.< / p >
2020-01-22 00:59:16 +00:00
< p > The segments are not removed if the value is zero.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --default_language < var > < language> < / var > < / span > < / kbd > < / dt >
< dd > < p > The first audio/text rendition in a group tagged with this language will
2018-02-10 23:37:42 +00:00
have ‘ ’ ‘ ’
2018-12-20 22:38:40 +00:00
correct default language for the content.< / p >
2020-01-22 00:59:16 +00:00
< p > This applies to both audio and text tracks. The default language for text
2018-12-20 22:38:40 +00:00
tracks can be overriden by ‘ ’ < / p >
2020-01-22 00:59:16 +00:00
< / dd >
< dt > < kbd > < span class = "option" > --default_text_language < var > < text_language> < / var > < / span > < / kbd > < / dt >
< dd > < p > Same as above, but this applies to text tracks only, and overrides the
default language for text tracks.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
2018-08-16 00:35:22 +00:00
< div class = "section" id = "ads-options" >
< h3 > Ads options< a class = "headerlink" href = "#ads-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --ad_cues < var > < start_time[;start_time]…> < / var > < / span > < / kbd > < / dt >
< dd > < p > List of cuepoint markers separated by semicolon. The start_time represents
2018-08-16 00:35:22 +00:00
the start of the cue marker in seconds (double precision) relative to the
start of the program. This flag preconditions content for
< a class = "reference external" href = "http://bit.ly/2KK10DD" > Dynamic Ad Insertion< / a > with Google Ad Manager.
For DASH, multiple periods will be generated with period boundaries at the
next key frame to the designated start times; For HLS, segments will be
terminated at the next key frame to the designated start times and
‘ ’
2020-01-22 00:59:16 +00:00
media playlist.< / p >
< / dd >
< / dl >
2018-08-16 00:35:22 +00:00
< / div >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "encryption-decryption-options" >
< h2 > Encryption / decryption options< a class = "headerlink" href = "#encryption-decryption-options" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > Shaka Packager supports three different types of key providers:< / p >
< ul class = "simple" >
2020-01-22 00:59:16 +00:00
< li > < p > Raw key: keys are provided in command line< / p > < / li >
< li > < p > Widevine: fetches keys from Widevine key server< / p > < / li >
< li > < p > PlayReady: fetches keys from PlayReady key server< / p > < / li >
2017-09-20 02:35:05 +00:00
< / ul >
< p > Different key providers cannot be specified at the same time.< / p >
2020-01-22 00:59:16 +00:00
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "p" > [< / span > < span class = "o" > --< / span > < span class = "n" > enable_widevine_encryption< / span > < span class = "o" > < < / span > < span class = "n" > Widevine< / span > < span class = "n" > Encryption< / span > < span class = "n" > Options< / span > < span class = "o" > > < / span > < span class = "p" > ]< / span > \
2018-05-23 23:12:00 +00:00
< span class = "p" > [< / span > < span class = "o" > --< / span > < span class = "n" > enable_widevine_decryption< / span > < span class = "o" > < < / span > < span class = "n" > Widevine< / span > < span class = "n" > Decryption< / span > < span class = "n" > Options< / span > < span class = "o" > > < / span > < span class = "p" > ]< / span > \
< span class = "p" > [< / span > < span class = "o" > --< / span > < span class = "n" > enable_raw_key_encryption< / span > < span class = "o" > < < / span > < span class = "n" > Raw< / span > < span class = "n" > Key< / span > < span class = "n" > Encryption< / span > < span class = "n" > Options< / span > < span class = "o" > > < / span > < span class = "p" > ]< / span > \
< span class = "p" > [< / span > < span class = "o" > --< / span > < span class = "n" > enable_raw_key_decryption< / span > < span class = "o" > < < / span > < span class = "n" > Raw< / span > < span class = "n" > Key< / span > < span class = "n" > Decryption< / span > < span class = "n" > Options< / span > < span class = "o" > > < / span > < span class = "p" > ]< / span > \
< span class = "p" > [< / span > < span class = "o" > --< / span > < span class = "n" > enable_playready_encryption< / span > < span class = "o" > < < / span > < span class = "n" > PlayReady< / span > < span class = "n" > Encryption< / span > < span class = "n" > Options< / span > < span class = "o" > > < / span > < span class = "p" > ]< / span >
2017-09-20 02:35:05 +00:00
< / pre > < / div >
< / div >
< div class = "section" id = "general-encryption-options" >
< h3 > General encryption options< a class = "headerlink" href = "#general-encryption-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --protection_scheme < var > < scheme> < / var > < / span > < / kbd > < / dt >
< dd > < p > Specify a protection scheme, ‘ ’ ‘ ’
schemes ‘ ’ ‘ ’ < / p >
< / dd >
< dt > < kbd > < span class = "option" > --vp9_subsample_encryption< / span > , < span class = "option" > --novp9_subsample_encryption< / span > < / kbd > < / dt >
< dd > < p > Enable / disable VP9 subsample encryption. Enabled by default.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --clear_lead < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Clear lead in seconds if encryption is enabled.
Shaka Packager does not support partial encrypted segments, all the
segments including the partial segment overlapping with the initial
‘ ’
encrypted. If segment_duration is greater than ‘ ’
first segment is not encrypted.
Default: 5< / p >
< / dd >
< dt > < kbd > < span class = "option" > --protection_systems< / span > < / kbd > < / dt >
< dd > < p > Protection systems to be generated. Supported protection systems include
2018-12-20 22:38:40 +00:00
Widevine, PlayReady, FairPlay, Marlin, and
2020-01-22 00:59:16 +00:00
CommonSystem (< a class = "reference external" href = "https://goo.gl/s8RIhr" > https://goo.gl/s8RIhr< / a > ).< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "raw-key-encryption-options" >
< h3 > Raw key encryption options< a class = "headerlink" href = "#raw-key-encryption-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --enable_raw_key_encryption< / span > < / kbd > < / dt >
< dd > < p > Enable encryption with raw key (keys provided in command line)). This
2018-08-16 00:35:22 +00:00
generates < a class = "reference external" href = "https://goo.gl/s8RIhr" > Common protection system< / a > if neither
– – –
protection systems or use –
2020-01-22 00:59:16 +00:00
systems automatically.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --enable_raw_key_decryption< / span > < / kbd > < / dt >
< dd > < p > Enable decryption with raw key (keys provided in command line).< / p >
< / dd >
< dt > < kbd > < span class = "option" > --keys < var > < key_info_string[,key_info_string][,key_info_string]…> < / var > < / span > < / kbd > < / dt >
< dd > < p > < strong > key_info_string< / strong > is of the form:< / p >
< div class = "highlight-default notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "n" > label< / span > < span class = "o" > =< < / span > < span class = "n" > label< / span > < span class = "o" > > < / span > < span class = "p" > :< / span > < span class = "n" > key_id< / span > < span class = "o" > =< < / span > < span class = "n" > key_id< / span > < span class = "o" > > < / span > < span class = "p" > :< / span > < span class = "n" > key< / span > < span class = "o" > =< < / span > < span class = "n" > key< / span > < span class = "o" > > < / span >
2017-10-24 22:51:02 +00:00
< / pre > < / div >
< / div >
< p > < em > label< / em > can be an arbitrary string or a predefined DRM label like AUDIO,
SD, HD, etc. Label with an empty string indicates the default key and
key_id. The < em > drm_label< / em > in < a class = "reference internal" href = "options/stream_descriptors.html" > < span class = "doc" > Stream descriptors< / span > < / a > ,
which can be implicit, determines which key info is applied to the stream
by matching the < em > drm_label< / em > with the < em > label< / em > in key info.< / p >
2020-01-22 00:59:16 +00:00
< p > < em > key_id< / em > and < em > key< / em > should be 32-digit hex strings.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --iv < var > < 16-digit or 32-digit hex string> < / var > < / span > < / kbd > < / dt >
< dd > < p > IV in hex string format. If not specified, a random IV will be generated.
2017-09-20 02:35:05 +00:00
This flag should only be used for testing. IV must be either 8 bytes
2020-01-22 00:59:16 +00:00
(16 digits HEX) or 16 bytes (32 digits in HEX).< / p >
< / dd >
< dt > < kbd > < span class = "option" > --pssh < var > < hex string> < / var > < / span > < / kbd > < / dt >
< dd > < p > One or more concatenated PSSH boxes in hex string format. If neither this
2018-08-16 00:35:22 +00:00
flag nor –
2020-01-22 00:59:16 +00:00
< a class = "reference external" href = "https://goo.gl/s8RIhr" > v1 common PSSH box< / a > will be generated.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "widevine-encryption-options" >
< h3 > Widevine encryption options< a class = "headerlink" href = "#widevine-encryption-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --enable_widevine_encryption< / span > < / kbd > < / dt >
< dd > < p > Enable encryption with Widevine key server. User should provide either
2018-02-10 23:37:42 +00:00
AES signing key (– –
2018-08-16 00:35:22 +00:00
(–
– –
2020-01-22 00:59:16 +00:00
multiple protection systems.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --enable_widevine_decryption< / span > < / kbd > < / dt >
< dd > < p > Enable decryption with Widevine key server. User should provide either
2018-02-10 23:37:42 +00:00
AES signing key (– –
2020-01-22 00:59:16 +00:00
(– < / p >
< / dd >
< dt > < kbd > < span class = "option" > --key_server_url < var > < url> < / var > < / span > < / kbd > < / dt >
< dd > < p > Key server url. Required for Widevine encryption and decryption.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --content_id < var > < hex> < / var > < / span > < / kbd > < / dt >
< dd > < p > Content identifier that uniquely identifies the content.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --policy < var > < policy> < / var > < / span > < / kbd > < / dt >
< dd > < p > The name of a stored policy, which specifies DRM content rights.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --max_sd_pixels < var > < pixels> < / var > < / span > < / kbd > < / dt >
< dd > < p > The video track is considered SD if its max pixels per frame is no higher
than < em > max_sd_pixels< / em > . Default: 442368 (768 x 576).< / p >
< / dd >
< dt > < kbd > < span class = "option" > --max_hd_pixels < var > < pixels> < / var > < / span > < / kbd > < / dt >
< dd > < p > The video track is considered HD if its max pixels per frame is higher than
2017-09-20 02:35:05 +00:00
< em > max_sd_pixels< / em > , but no higher than < em > max_hd_pixels< / em > . Default: 2073600
2020-01-22 00:59:16 +00:00
(1920 x 1080).< / p >
< / dd >
< dt > < kbd > < span class = "option" > --max_uhd1_pixels < var > < pixels> < / var > < / span > < / kbd > < / dt >
< dd > < p > The video track is considered UHD1 if its max pixels per frame is higher
2017-09-20 02:35:05 +00:00
than < em > max_hd_pixels< / em > , but no higher than < em > max_uhd1_pixels< / em > . Otherwise it is
2020-01-22 00:59:16 +00:00
UHD2. Default: 8847360 (4096 x 2160).< / p >
< / dd >
< dt > < kbd > < span class = "option" > --signer < var > < signer> < / var > < / span > < / kbd > < / dt >
< dd > < p > The name of the signer.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --aes_signing_key < var > < hex> < / var > < / span > < / kbd > < / dt >
< dd > < p > AES signing key in hex string. < em > aes_signing_iv< / em > is required if
2017-09-20 02:35:05 +00:00
< em > aes_signing_key< / em > is specified. This option is exclusive with
2020-01-22 00:59:16 +00:00
< em > rsa_signing_key_path< / em > .< / p >
< / dd >
< dt > < kbd > < span class = "option" > --aes_signing_iv < var > < hex> < / var > < / span > < / kbd > < / dt >
< dd > < p > AES signing iv in hex string.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --rsa_signing_key_path < var > < file path> < / var > < / span > < / kbd > < / dt >
< dd > < p > Path to the file containing PKCS#1 RSA private key for request signing.
This option is exclusive with < em > aes_signing_key< / em > .< / p >
< / dd >
< dt > < kbd > < span class = "option" > --crypto_period_duration < var > < seconds> < / var > < / span > < / kbd > < / dt >
< dd > < p > Defines how often key rotates. If it is non-zero, key rotation is enabled.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --group_id < var > < hex> < / var > < / span > < / kbd > < / dt >
< dd > < p > Identifier for a group of licenses.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< div class = "section" id = "playready-encryption-options" >
2018-05-23 23:12:00 +00:00
< h3 > PlayReady encryption options< a class = "headerlink" href = "#playready-encryption-options" title = "Permalink to this headline" > ¶< / a > < / h3 >
2020-01-22 00:59:16 +00:00
< dl class = "option-list" >
< dt > < kbd > < span class = "option" > --enable_playready_encryption< / span > < / kbd > < / dt >
< dd > < p > Enable encryption with PlayReady key. This generates PlayReady protection
2018-08-16 00:35:22 +00:00
system if – –
2020-01-22 00:59:16 +00:00
generate multiple protection systems.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --playready_server_url < var > < url> < / var > < / span > < / kbd > < / dt >
< dd > < p > PlayReady packaging server url.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --program_identifier < var > < program_identifier> < / var > < / span > < / kbd > < / dt >
< dd > < p > Program identifier for packaging request.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --ca_file < var > < file path> < / var > < / span > < / kbd > < / dt >
< dd > < p > Absolute path to the certificate authority file for the server cert.
PEM format. Optional, depends on server configuration.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --client_cert_file < var > < file path> < / var > < / span > < / kbd > < / dt >
< dd > < p > Absolute path to client certificate file. Optional, depends on server
configuration.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --client_cert_private_key_file < var > < file path> < / var > < / span > < / kbd > < / dt >
< dd > < p > Absolute path to the private key file. Optional, depends on server
configuration.< / p >
< / dd >
< dt > < kbd > < span class = "option" > --client_cert_private_key_password < var > < string> < / var > < / span > < / kbd > < / dt >
< dd > < p > Password to the private key file. Optional, depends on server configuration.< / p >
< / dd >
< / dl >
2017-09-20 02:35:05 +00:00
< / div >
< / div >
< / div >
< / div >
< / div >
< / div >
< div class = "clearer" > < / div >
< / div >
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "genindex.html" title = "General Index"
>index< / a > < / li >
< li class = "right" >
< a href = "tutorials/tutorials.html" title = "Tutorials"
>next< / a > |< / li >
< li class = "right" >
< a href = "index.html" title = "Welcome to Shaka Packager’
>previous< / a > |< / li >
< li class = "nav-item nav-item-0" > < a href = "index.html" > Shaka Packager documentation< / a > » < / li >
< / ul >
< / div >
< div class = "footer" role = "contentinfo" >
© Copyright 2017, Google.
2020-01-22 00:59:16 +00:00
Created using < a href = "http://sphinx-doc.org/" > Sphinx< / a > 2.3.1.
2017-09-20 02:35:05 +00:00
< / div >
< / body >
< / html >
