Shaka Packager

https://shaka-project.github.io/shaka-packager/html/
Admin
Shaka Packager is a media packaging and encryption tool for preparing video content for DASH, HLS,...
Tokens:48,205
Snippets:615
Trust Score:8.3
Update:4 months ago
Show doc for...
Tokens:
Raw
### Custom Installation Path and Destination

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Customize the installation output location using --prefix and the DESTDIR environment variable. This example installs to 'foo' and uses '/usr' as the prefix.

```shell
DESTDIR=foo cmake --install build/ --strip --config Release --prefix=/usr
```

--------------------------------

### Example UDP File URL

Source: https://shaka-project.github.io/shaka-packager/html/_sources/options/udp_file_options.rst.txt

An example demonstrating how to use UDP file options with specific parameters.

```text
udp://224.1.2.30:88?interface=10.11.12.13&reuse=1
```

--------------------------------

### Install OpenSUSE Dependencies

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Use the 'zypper' command to install build dependencies on OpenSUSE systems. Ensure GCC 9+ is available or installed.

```shell
zypper in -y \
        curl which \
        cmake gcc9-c++ git ninja python3
```

--------------------------------

### Install Linux Build Dependencies

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Installs essential build tools and libraries on Ubuntu using apt-get.

```shell
sudo apt-get update
sudo apt-get install -y \
        curl \
        build-essential cmake git ninja-build python3
```

--------------------------------

### Install Debian/Ubuntu Dependencies

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Use the 'apt-get' command to install build dependencies on Debian and Ubuntu systems.

```shell
apt-get install -y \
        curl \
        build-essential cmake git ninja-build python3
```

--------------------------------

### Install Dependencies on Alpine Linux

Source: https://shaka-project.github.io/shaka-packager/html/build_instructions.html

Use the `apk` command to install build dependencies on Alpine Linux.

```bash
apk add --no-cache \
        bash curl \
        bsd-compat-headers linux-headers \
        build-base cmake git ninja python3

```

--------------------------------

### Multi-DRM (Widevine and PlayReady) Example

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/widevine.rst.txt

Example command for generating content protected with both Widevine and PlayReady DRM systems. Uses AES signing for Widevine and specifies the desired protection systems.

```bash
packager \
      in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
      in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
      in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
      in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
      in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
      --enable_widevine_encryption \
      --key_server_url https://license.uat.widevine.com/cenc/getcontentkey/widevine_test \
      --content_id 7465737420636f6e74656e74206964 \
      --signer widevine_test \
      --aes_signing_key 1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9 \
      --aes_signing_iv d58ce954203b7c9a9a9d467f59839249 \
      --protection_systems Widevine,PlayReady \
      --mpd_output h264.mpd
```

--------------------------------

### Shaka Packager Example: Multi-DRM (Widevine and PlayReady)

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/widevine.html

Example command for packaging H.264 streams with both Widevine and PlayReady encryption using AES signing. This demonstrates multi-DRM support by specifying multiple protection systems.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
  --enable_widevine_encryption \
  --key_server_url https://license.uat.widevine.com/cenc/getcontentkey/widevine_test \
  --content_id 7465737420636f6e74656e74206964 \
  --signer widevine_test \
  --aes_signing_key 1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9 \
  --aes_signing_iv d58ce954203b7c9a9a9d467f59839249 \
  --protection_systems Widevine,PlayReady
  --mpd_output h264.mpd

```

--------------------------------

### Shaka Packager Example: 'cbcs' Protection Scheme with Widevine

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/widevine.html

Example command for packaging H.264 streams with Widevine encryption using the 'cbcs' protection scheme and AES signing. Similar to the previous example but specifies the protection scheme.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
  --protection_scheme cbcs \
  --enable_widevine_encryption \
  --key_server_url https://license.uat.widevine.com/cenc/getcontentkey/widevine_test \
  --content_id 7465737420636f6e74656e74206964 \
  --signer widevine_test \
  --aes_signing_key 1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9 \
  --aes_signing_iv d58ce954203b7c9a9a9d467f59839249 \
  --mpd_output h264.mpd \
  --hls_master_playlist_output h264_master.m3u8

```

--------------------------------

### Get Shaka Packager Help

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/basic_usage.rst.txt

Use the --help flag to display all available command-line options and their descriptions.

```bash
$ packager --help
```

--------------------------------

### Install Ninja on macOS

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Installs the Ninja build system on macOS using Homebrew.

```shell
brew install ninja
```

--------------------------------

### Run Caddy Server

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/http_upload.rst.txt

Command to start the Caddy web server with the specified Caddyfile configuration.

```bash
caddy -conf Caddyfile
```

--------------------------------

### Install Alpine Linux Dependencies

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Use the 'apk' command to install build dependencies on Alpine Linux. Ensure to use the --no-cache flag for a cleaner installation.

```shell
apk add --no-cache \
        bash curl \
        bsd-compat-headers linux-headers \
        build-base cmake git ninja python3
```

--------------------------------

### Shaka Packager Example: DASH and HLS Output with Widevine

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/widevine.html

Example command to package H.264 streams for both DASH and HLS with Widevine encryption using AES signing. Includes key server details and content identifiers.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
  --enable_widevine_encryption \
  --key_server_url https://license.uat.widevine.com/cenc/getcontentkey/widevine_test \
  --content_id 7465737420636f6e74656e74206964 \
  --signer widevine_test \
  --aes_signing_key 1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9 \
  --aes_signing_iv d58ce954203b7c9a9a9d467f59839249 \
  --mpd_output h264.mpd \
  --hls_master_playlist_output h264_master.m3u8

```

--------------------------------

### Install Shaka Packager to Custom Location

Source: https://shaka-project.github.io/shaka-packager/html/build_instructions.html

Install Shaka Packager to a custom location by specifying the prefix and DESTDIR.

```bash
DESTDIR=foo cmake --install build/ --strip --config Release --prefix=/usr

```

--------------------------------

### Install Shaka Packager

Source: https://shaka-project.github.io/shaka-packager/html/build_instructions.html

Install Shaka Packager using CMake, stripping binaries and specifying the release configuration.

```bash
cmake --install build/ --strip --config Release

```

--------------------------------

### Check macOS SDK

Source: https://shaka-project.github.io/shaka-packager/html/build_instructions.html

Lists available macOS SDKs to verify installation.

```bash
ls `xcode-select -p`/Platforms/MacOSX.platform/Developer/SDKs

```

--------------------------------

### Install Windows Dependencies with Chocolatey

Source: https://shaka-project.github.io/shaka-packager/html/build_instructions.html

Installs necessary tools and build components on Windows using Chocolatey.

```powershell
choco install -y \
  git cmake ninja python \
  visualstudio2022community visualstudio2022-workload-nativedesktop \
  visualstudio2022buildtools windows-sdk-10.0

```

--------------------------------

### Run Nginx Server

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/http_upload.rst.txt

Starts an Nginx server with a specified configuration and root directory for handling HTTP PUT requests.

```bash
nginx -p `pwd` -c nginx.conf -g "daemon off;"
```

--------------------------------

### Install Arch Linux Dependencies

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Use the 'pacman' command to install build dependencies on Arch Linux. The --needed and --noconfirm flags are used for efficiency.

```shell
pacman -Suy --needed --noconfirm \
        core/which \
        cmake gcc git ninja python3
```

--------------------------------

### Install Shaka Packager

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Install Shaka Packager after a successful build. The --strip flag removes debugging symbols to reduce binary size.

```shell
cmake --install build/ --strip --config Release
```

--------------------------------

### DASH Live Profile with Ad Cues

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/ads.rst.txt

This example demonstrates how to configure Shaka Packager for DASH live streaming with ad insertion. It specifies multiple input streams and uses the --ad_cues option to define midroll cue points.

```bash
$ packager \
  'in=h264_baseline_360p_600.mp4,stream=audio,init_segment=audio/init.mp4,segment_template=audio/$Number$.m4s' \
  'in=input_text.vtt,stream=text,init_segment=text/init.mp4,segment_template=text/$Number$.m4s' \
  'in=h264_baseline_360p_600.mp4,stream=video,init_segment=h264_360p/init.mp4,segment_template=h264_360p/$Number$.m4s' \
  'in=h264_main_480p_1000.mp4,stream=video,init_segment=h264_480p/init.mp4,segment_template=h264_480p/$Number$.m4s' \
  'in=h264_main_720p_3000.mp4,stream=video,init_segment=h264_720p/init.mp4,segment_template=h264_720p/$Number$.m4s' \
  'in=h264_high_1080p_6000.mp4,stream=video,init_segment=h264_1080p/init.mp4,segment_template=h264_1080p/$Number$.m4s' \
  --ad_cues 600;1800;3000 \
  --generate_static_live_mpd --mpd_output h264.mpd
```

--------------------------------

### Install Fedora Dependencies

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Use the 'yum' command to install build dependencies on Fedora systems. This includes essential development tools and libraries.

```shell
yum install -y \
        which \
        libatomic \
        cmake gcc-c++ git ninja-build python3
```

--------------------------------

### DASH Packaging Command

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/ffmpeg_piping.rst.txt

Example Shaka Packager command to create DASH manifests and segments from audio and video streams received via UDP.

```bash
$ packager \
  'in=udp://127.0.0.1:40000,stream=audio,init_segment=live_cam_audio.mp4,segment_template=live_cam_audio_$Number$.m4s' \
  'in=udp://127.0.0.1:40000,stream=video,init_segment=live_cam_video.mp4,segment_template=live_cam_video_$Number$.m4s' \
  --mpd_output live_cam.mpd
```

--------------------------------

### DASH Ad Insertion with Live Profile

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/ads.html

Example of preconditioning content for Dynamic Ad Insertion with Google Ad Manager using DASH and a live profile. It inserts three midroll cue markers.

```bash
$ packager \n  'in=h264_baseline_360p_600.mp4,stream=audio,init_segment=audio/init.mp4,segment_template=audio/$Number$.m4s' \n  'in=input_text.vtt,stream=text,init_segment=text/init.mp4,segment_template=text/$Number$.m4s' \n  'in=h264_baseline_360p_600.mp4,stream=video,init_segment=h264_360p/init.mp4,segment_template=h264_360p/$Number$.m4s' \n  'in=h264_main_480p_1000.mp4,stream=video,init_segment=h264_480p/init.mp4,segment_template=h264_480p/$Number$.m4s' \n  'in=h264_main_720p_3000.mp4,stream=video,init_segment=h264_720p/init.mp4,segment_template=h264_720p/$Number$.m4s' \n  'in=h264_high_1080p_6000.mp4,stream=video,init_segment=h264_1080p/init.mp4,segment_template=h264_1080p/$Number$.m4s' \n  --ad_cues 600;1800;3000 \n  --generate_static_live_mpd --mpd_output h264.mpd

```

--------------------------------

### Install Windows Build Dependencies with Chocolatey

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Installs necessary tools and workloads for Shaka Packager development on Windows using Chocolatey.

```powershell
choco install -y \
  git cmake ninja python \
  visualstudio2022community visualstudio2022-workload-nativedesktop \
  visualstudio2022buildtools windows-sdk-10.0
```

--------------------------------

### DASH Ad Insertion with On-Demand Profile

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/ads.html

Example of preconditioning content for Dynamic Ad Insertion using DASH with an on-demand profile. This generates six single-segment media files.

```bash
$ packager \n  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \n  in=input_text.vtt,stream=text,output=output_text.mp4 \n  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \n  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \n  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \n  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \n  --ad_cues 600;1800;3000 \n  --mpd_output h264.mpd

```

--------------------------------

### DASH On-Demand Profile with Ad Cues

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/ads.rst.txt

This example shows how to set up Shaka Packager for DASH on-demand streaming with ad insertion. It generates single-segment media files for each stream and uses --ad_cues for ad markers.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
  in=input_text.vtt,stream=text,output=output_text.mp4 \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
  --ad_cues 600;1800;3000 \
  --mpd_output h264.mpd
```

--------------------------------

### Shaka Packager Raw Key Encryption with Custom PSSH

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/raw_key.rst.txt

Example demonstrating raw key encryption with a pre-generated PSSH. This is useful when you have specific PSSH data that needs to be included in the output.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4,drm_label=AUDIO \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4,drm_label=SD \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4,drm_label=SD \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4,drm_label=HD \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4,drm_label=HD \
  --enable_raw_key_encryption \
  --keys label=AUDIO:key_id=f3c5e0361e6654b28f8049c778b23946:key=a4631a153a443df9eed0593043db7519,label=SD:key_id=abba271e8bcf552bbd2e86a434a9a5d9:key=69eaa802a6763af979e8d1940fb88392,label=HD:key_id=6d76f25cb17f5e16b8eaef6bbf582d8e:key=cb541084c99731aef4fff74500c12ead \
  --pssh 000000317073736800000000EDEF8BA979D64ACEA3C827DCD51D21ED00000011220F7465737420636F6E74656E74206964 \
  --mpd_output h264.mpd \
  --hls_master_playlist_output h264_master.m3u8
```

--------------------------------

### HLS with Transport Streams and Ad Cues

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/ads.rst.txt

This example demonstrates configuring Shaka Packager for HLS streaming using transport streams, incorporating ad insertion. It specifies input files and uses --ad_cues to set ad marker times.

```bash
$ packager \
  'in=h264_baseline_360p_600.mp4,stream=audio,segment_template=audio_$Number$.aac' \
  'in=input_text.vtt,stream=text,segment_template=output_text_$Number$.vtt' \
  'in=h264_baseline_360p_600.mp4,stream=video,segment_template=h264_360p_$Number$.ts' \
  'in=h264_main_480p_1000.mp4,stream=video,segment_template=h264_480p_$Number$.ts' \
  'in=h264_main_720p_3000.mp4,stream=video,segment_template=h264_720p_$Number$.ts' \
  'in=h264_high_1080p_6000.mp4,stream=video,segment_template=h264_1080p_$Number$.ts' \
  --ad_cues 600;1800;3000 \
  --hls_master_playlist_output h264_master.m3u8
```

--------------------------------

### DASH Packaging Command Synopsis

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/dash.html

This is the basic command structure for packaging DASH content. Use this as a starting point for your packaging tasks, specifying stream descriptors and the MPD output path.

```bash
$ packager <stream_descriptor> ... \
  --mpd_output <manifest_output_path> \
  [Other DASH options] \
  [Other options, e.g. DRM options, HLS options]

```

--------------------------------

### Enable CRB Repository on CentOS

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Enable the Code Ready Builder (CRB) repository on CentOS systems, which is necessary for installing Ninja.

```shell
dnf update -y
dnf install -y yum-utils
dnf config-manager --set-enabled crb
```

--------------------------------

### Printf Format Tag Example

Source: https://shaka-project.github.io/shaka-packager/html/options/segment_template_formatting.html

Illustrates the printf format tag used for padding with zeros. The width parameter specifies the minimum number of characters.

```text
%0[width]d
```

--------------------------------

### Caddyfile Configuration for HTTP Upload

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/http_upload.rst.txt

Configure Caddy to serve files from a root directory and enable HTTP PUT uploads to a specified location. This setup is useful for testing upload functionality.

```caddy
root /var/spool
redir /hls-live {
    if {path} is "/"
}
browse

upload /hls-live {
    to "/var/spool/hls-live"
}
```

--------------------------------

### HLS Ad Insertion using Transport Streams

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/ads.html

Example of preconditioning content for Dynamic Ad Insertion using HLS and transport streams. Segments are terminated at key frames, and an '#EXT-X-PLACEMENT-OPPORTUNITY' tag is inserted.

```bash
$ packager \n  'in=h264_baseline_360p_600.mp4,stream=audio,segment_template=audio_$Number$.aac' \n  'in=input_text.vtt,stream=text,segment_template=output_text_$Number$.vtt' \n  'in=h264_baseline_360p_600.mp4,stream=video,segment_template=h264_360p_$Number$.ts' \n  'in=h264_main_480p_1000.mp4,stream=video,segment_template=h264_480p_$Number$.ts' \n  'in=h264_main_720p_3000.mp4,stream=video,segment_template=h264_720p_$Number$.ts' \n  'in=h264_high_1080p_6000.mp4,stream=video,segment_template=h264_1080p_$Number$.ts' \n  --ad_cues 600;1800;3000 \n  --hls_master_playlist_output h264_master.m3u8

```

--------------------------------

### DASH and HLS Output with Widevine Encryption

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/widevine.rst.txt

Example command to generate both DASH and HLS outputs with Widevine encryption using AES signing. Includes multiple input streams for adaptive bitrate.

```bash
packager \
      in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
      in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
      in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
      in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
      in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
      --enable_widevine_encryption \
      --key_server_url https://license.uat.widevine.com/cenc/getcontentkey/widevine_test \
      --content_id 7465737420636f6e74656e74206964 \
      --signer widevine_test \
      --aes_signing_key 1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9 \
      --aes_signing_iv d58ce954203b7c9a9a9d467f59839249 \
      --mpd_output h264.mpd \
      --hls_master_playlist_output h264_master.m3u8
```

--------------------------------

### Package Text Tracks with Non-Zero Start Times for VOD

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/text.rst.txt

When dealing with input MPEG-TS files that have high PTS values, use the --generate_static_live_mpd flag to ensure correct presentationTimeOffset values in the DASH manifest for VOD content.

```bash
$ packager \
      --generate_static_live_mpd \
      --segment_duration 4 \
      --mpd_output manifest.mpd \
      'in=recording.ts,stream=video,init_segment=video/init.mp4,segment_template=video/$Number$.m4s' \
      'in=recording.ts,stream=text,cc_index=888,lang=en,init_segment=text/init.mp4,segment_template=text/$Number$.m4s'
```

--------------------------------

### Set Up HTTP Reflector

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/http_upload.html

Download, make executable, and run a Python script to act as a dummy HTTP server for testing uploads. Ensure it's listening on the correct port.

```bash
# Ready
wget https://gist.githubusercontent.com/amotl/3ed38e461af743aeeade5a5a106c1296/raw/httpd-reflector.py
chmod +x httpd-reflector.py
./httpd-reflector.py --port 6767

```

--------------------------------

### Initialize and Run Shaka Packager

Source: https://shaka-project.github.io/shaka-packager/html/_sources/library.rst.txt

This C++ snippet demonstrates how to set up and execute the Shaka Packager. It involves defining packaging parameters, stream descriptors for video and audio, and then initializing and running the packager. Ensure proper error handling for the status checks.

```c++
shaka::Packager packager;

    // Setup packaging parameters.
    shaka::PackagingParams packaging_params;
    // Use default parameters here.

    // Setup stream descriptors.
    std::vector<shaka::StreamDescriptor> stream_descriptors;
    shaka::StreamDescriptor stream_descriptor;
    stream_descriptor.input = "input.mp4";
    stream_descriptor.stream_selector = "video";
    stream_descriptor.output = "output_video.mp4";
    stream_descriptors.push_back(stream_descriptor);
    shaka::StreamDescriptor stream_descriptor;
    stream_descriptor.input = "input.mp4";
    stream_descriptor.stream_selector = "audio";
    stream_descriptor.output = "output_audio.mp4";
    stream_descriptors.push_back(stream_descriptor);

    shaka::Status status = packager.Initialize(packaging_params,
                                               stream_descriptors);
    if (!status.ok()) { ... }
    status = packager.Run();
    if (!status.ok()) { ... }
```

--------------------------------

### Accept Xcode License

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Run this command to accept the Xcode license agreement if prompted. Use sudo for system-wide acceptance.

```shell
xcodebuild -license
```

```shell
sudo xcodebuild -license
```

--------------------------------

### Set Start Segment Number

Source: https://shaka-project.github.io/shaka-packager/html/documentation.html

Specifies the starting number for segments, used in DASH SegmentTemplate and HLS segment naming.

```command-line
--start_segment_number 1
```

--------------------------------

### Accept Xcode License Agreement with Sudo

Source: https://shaka-project.github.io/shaka-packager/html/build_instructions.html

Run this command with `sudo` to accept the Xcode license agreement for all users on the machine.

```bash
sudo xcodebuild -license

```

--------------------------------

### Segment Template Formatting Example

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/live.html

This example shows how to use segment template formatting for generating segment URLs. It includes an escape sequence for '$' and a formatted segment number.

```text
segment_$Number$.ts
```

--------------------------------

### Static Live MPD Packaging

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/dash.html

Creates segmented media files and a static live DASH manifest for live streaming. Each stream is configured with init and segment templates.

```bash
$ packager \
  'in=h264_baseline_360p_600.mp4,stream=audio,init_segment=audio/init.mp4,segment_template=audio/$Number$.m4s' \
  'in=input_text.vtt,stream=text,init_segment=text/init.mp4,segment_template=text/$Number$.m4s' \
  'in=h264_baseline_360p_600.mp4,stream=video,init_segment=h264_360p/init.mp4,segment_template=h264_360p/$Number$.m4s' \
  'in=h264_main_480p_1000.mp4,stream=video,init_segment=h264_480p/init.mp4,segment_template=h264_480p/$Number$.m4s' \
  'in=h264_main_720p_3000.mp4,stream=video,init_segment=h264_720p/init.mp4,segment_template=h264_720p/$Number$.m4s' \
  'in=h264_high_1080p_6000.mp4,stream=video,init_segment=h264_1080p/init.mp4,segment_template=h264_1080p/$Number$.m4s' \
  --generate_static_live_mpd --mpd_output h264.mpd

```

--------------------------------

### Static Live DASH Packaging

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/dash.rst.txt

This command is used to generate a static DASH manifest for live-like streaming. It creates separate init and media segments for each stream, organized into directories, and a DASH manifest describing these segments.

```bash
$ packager \
  'in=h264_baseline_360p_600.mp4,stream=audio,init_segment=audio/init.mp4,segment_template=audio/$Number$.m4s' \
  'in=input_text.vtt,stream=text,init_segment=text/init.mp4,segment_template=text/$Number$.m4s' \
  'in=h264_baseline_360p_600.mp4,stream=video,init_segment=h264_360p/init.mp4,segment_template=h264_360p/$Number$.m4s' \
  'in=h264_main_480p_1000.mp4,stream=video,init_segment=h264_480p/init.mp4,segment_template=h264_480p/$Number$.m4s' \
  'in=h264_main_720p_3000.mp4,stream=video,init_segment=h264_720p/init.mp4,segment_template=h264_720p/$Number$.m4s' \
  'in=h264_high_1080p_6000.mp4,stream=video,init_segment=h264_1080p/init.mp4,segment_template=h264_1080p/$Number$.m4s' \
  --generate_static_live_mpd --mpd_output h264.mpd
```

--------------------------------

### VoD Output with Non-Zero Start Times for Teletext

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/text.html

Generates DASH manifests with correct `presentationTimeOffset` for VoD inputs that have high PTS values, ensuring proper timing for recordings that started mid-broadcast.

```bash
$ packager \
  --generate_static_live_mpd \
  --segment_duration 4 \
  --mpd_output manifest.mpd \
  'in=recording.ts,stream=video,init_segment=video/init.mp4,segment_template=video/$Number$.m4s' \
  'in=recording.ts,stream=text,cc_index=888,lang=en,init_segment=text/init.mp4,segment_template=text/$Number$.m4s'
```

--------------------------------

### Clone Shaka Packager Repository

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Clone the Shaka Packager repository and its submodules to get the complete source code.

```shell
git clone --recurse-submodules https://github.com/shaka-project/shaka-packager.git
```

--------------------------------

### Configure and Build Shaka Packager (Windows)

Source: https://shaka-project.github.io/shaka-packager/html/build_instructions.html

Configure the Shaka Packager build on Windows using the default CMake backend and build with a specific configuration.

```bash
cmake -B build
cmake --build build --parallel --config Release

```

--------------------------------

### HLS Packaging Synopsis

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/hls.html

This is the basic command structure for packaging HLS content. Specify stream descriptors, the master playlist output path, and other HLS or general options.

```bash
$ packager <stream_descriptor> ... \
  --hls_master_playlist_output <master_playlist_output_path> \
  [Other HLS options] \
  [Other options, e.g. DRM options, DASH options]

```

--------------------------------

### Segment Template with Formatted Number

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/live.html

This example demonstrates segment template formatting using the $Number$ identifier with a width of 6 and zero-padding.

```text
segment_$Number%06d$.ts
```

--------------------------------

### Segment Template with Time Formatting

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/live.html

This example illustrates segment template formatting using the $Time$ identifier with a specific width for zero-padding.

```text
segment_$Time$.ts
```

--------------------------------

### FFmpeg Pipe Output

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/ffmpeg_piping.rst.txt

Use FFmpeg to write data to a named pipe, which Shaka Packager can then read. Ensure the pipe is created before starting FFmpeg.

```bash
$ ffmpeg ... -f mpegts pipe: > pipe1
```

--------------------------------

### PlayReady Encryption Synopsis

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/playready.html

Command-line synopsis for enabling PlayReady encryption with Shaka Packager. Use this to specify the key server URL and other necessary parameters for encryption.

```bash
$ packager <stream_descriptor> ... \
  --enable_playready_encryption \
  --playready_server_url <playready_server_url> \
  --program_identifier <program_identifier> \
  --client_cert_file <client_cert_file> \
  --client_cert_private_key_file <client_cert_private_key_file> \
  --client_cert_private_key_password <client_cert_private_key_password> \
  --ca_file <ca_file> \
  [Other options, e.g. DASH options, HLS options]

```

--------------------------------

### Saving Verbose Output to File

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/debugging.rst.txt

Redirects verbose logging output to a file named 'debug.log' for easier analysis. This example enables detailed debugging for 'text_chunker'.

```bash
$ packager input.ts --vmodule=text_chunker=3 2>&1 | tee debug.log
```

--------------------------------

### VP9 Encoding for 360p with Opus Audio

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/encoding.rst.txt

Encodes video to VP9 at 360p resolution with Opus audio and a GOP size of 72. This is an example for web-optimized adaptive streams.

```bash
$ ffmpeg -i original.mp4 \
  -strict -2 -c:a opus \
  -vf "scale=-2:360" \
  -c:v libvpx-vp9 -profile:v 0 \
  -keyint_min 72 -g 72 \
  -tile-columns 4 -frame-parallel 1 -speed 1 \
  -auto-alt-ref 1 -lag-in-frames 25 \
  -b:v 300k \
  -y vp9_360p_300.webm
```

--------------------------------

### Download and Run HTTP Reflector Script

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/http_upload.rst.txt

Download the httpd-reflector.py script, make it executable, and run it on port 6767. This script acts as a dummy HTTP sink to capture and inspect uploaded data.

```bash
wget https://gist.githubusercontent.com/amotl/3ed38e461af743aeeade5a5a106c1296/raw/httpd-reflector.py
chmod +x httpd-reflector.py
./httpd-reflector.py --port 6767
```

--------------------------------

### Acquire and Transcode RTMP Stream with FFmpeg

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/low_latency.rst.txt

Acquires an RTMP stream and transcodes it into MPEG-TS format, piping the output to a FIFO for Shaka Packager. Ensure FFmpeg is installed and accessible.

```bash
ffmpeg -fflags nobuffer -threads 0 -y \
    -i rtmp://184.72.239.149/vod/mp4:bigbuckbunny_450.mp4 \
    -pix_fmt yuv420p -vcodec libx264 -preset:v superfast -acodec aac \
    -f mpegts pipe: > ${PIPE}
```

--------------------------------

### Multiple Language Outputs

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/text.rst.txt

This command demonstrates packaging WebVTT subtitles for multiple languages into separate MP4 files.

```bash
$ packager \
  in=in_en.vtt,stream=text,language=en,output=out_en.mp4 \
  in=in_sp.vtt,stream=text,language=sp,output=out_sp.mp4 \
  in=in_fr.vtt,stream=text,language=fr,output=out_fr.mp4
```

--------------------------------

### Configure and Build Shaka Packager (Windows)

Source: https://shaka-project.github.io/shaka-packager/html/_sources/build_instructions.md.txt

Configure the Shaka Packager build on Windows using CMake. Omit -G Ninja for the default backend and use --config for build configuration.

```shell
cmake -B build
cmake --build build --parallel --config Release
```

--------------------------------

### Specifying Input and Output Files

Source: https://shaka-project.github.io/shaka-packager/html/options/stream_descriptors.html

Use the 'input' and 'output' fields to specify the source media file path and the required output file path, respectively.

```text
input=input.mp4,stream=video,output=output.mp4
```

--------------------------------

### Basic DASH On-Demand Packaging

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/dash.rst.txt

Use this command to package multiple fragmented MP4 streams (video and audio) along with subtitle files and generate a DASH manifest for VOD content.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
  in=input_text.vtt,stream=text,output=output_text.vtt \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
  --mpd_output h264.mpd
```

--------------------------------

### DASH On-Demand Packaging with Trick-Play Tracks

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/dash.rst.txt

This command extends the basic on-demand packaging by adding trick-play tracks, which are useful for fast-forwarding or rewinding through content. It generates additional fragmented MP4 files for these tracks.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
  in=input_text.vtt,stream=text,output=output_text.vtt \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4,trick_play_factor=1 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4,trick_play_factor=1 \
  --mpd_output h264.mpd
```

--------------------------------

### Shaka Packager Raw Key Encryption with Common PSSH Generation

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/raw_key.rst.txt

Example showing raw key encryption where Shaka Packager generates a common PSSH box. This is used when custom PSSH data is not provided.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4,drm_label=AUDIO \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4,drm_label=SD \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4,drm_label=SD \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4,drm_label=HD \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4,drm_label=HD \
  --enable_raw_key_encryption \
  --keys label=AUDIO:key_id=f3c5e0361e6654b28f8049c778b23946:key=a4631a153a443df9eed0593043db7519,label=SD:key_id=abba271e8bcf552bbd2e86a434a9a5d9:key=69eaa802a6763af979e8d1940fb88392,label=HD:key_id=6d76f25cb17f5e16b8eaef6bbf582d8e:key=cb541084c99731aef4fff74500c12ead \
  --mpd_output h264.mpd
```

--------------------------------

### PlayReady Encryption Synopsis

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/playready.rst.txt

Use this command to enable PlayReady encryption and specify the PlayReady Key Server details. The client certificate and CA file parameters are optional.

```bash
$ packager <stream_descriptor> \
  --enable_playready_encryption \
  --playready_server_url <playready_server_url> \
  --program_identifier <program_identifier> \
  --client_cert_file <client_cert_file> \
  --client_cert_private_key_file <client_cert_private_key_file> \
  --client_cert_private_key_password <client_cert_private_key_password> \
  --ca_file <ca_file> \
  [Other options, e.g. DASH options, HLS options]
```

--------------------------------

### DASH and HLS Output with 'cbcs' Protection Scheme

Source: https://shaka-project.github.io/shaka-packager/html/_sources/tutorials/widevine.rst.txt

Example command for generating DASH and HLS outputs using the 'cbcs' protection scheme with Widevine encryption and AES signing. This is an alternative to the default 'cenc' scheme.

```bash
packager \
      in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
      in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
      in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
      in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
      in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
      --protection_scheme cbcs \
      --enable_widevine_encryption \
      --key_server_url https://license.uat.widevine.com/cenc/getcontentkey/widevine_test \
      --content_id 7465737420636f6e74656e74206964 \
      --signer widevine_test \
      --aes_signing_key 1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9 \
      --aes_signing_iv d58ce954203b7c9a9a9d467f59839249 \
      --mpd_output h264.mpd \
      --hls_master_playlist_output h264_master.m3u8
```

--------------------------------

### Synopsis for Ad Insertion

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/ads.html

This is the general command-line synopsis for using Shaka Packager with ad cue markers.

```bash
$ packager <stream_descriptor> ... \n  --ad_cues <start_time[;start_time]...> \n  [Other options, e.g. DRM options, DASH options, HLS options]

```

--------------------------------

### Combine Log Control and Module Debugging

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/debugging.html

Combine global log level control with module-specific verbose logging. This example suppresses routine INFO messages globally while enabling detailed debug output from a specific module.

```bash
$ packager input.ts --minloglevel=1 --vmodule=my_module=2

```

--------------------------------

### On-Demand Packaging

Source: https://shaka-project.github.io/shaka-packager/html/tutorials/dash.html

Creates single-track fragmented MP4 streams for video and audio, along with a subtitle file and a DASH manifest for on-demand playback.

```bash
$ packager \
  in=h264_baseline_360p_600.mp4,stream=audio,output=audio.mp4 \
  in=input_text.vtt,stream=text,output=output_text.vtt \
  in=h264_baseline_360p_600.mp4,stream=video,output=h264_360p.mp4 \
  in=h264_main_480p_1000.mp4,stream=video,output=h264_480p.mp4 \
  in=h264_main_720p_3000.mp4,stream=video,output=h264_720p.mp4 \
  in=h264_high_1080p_6000.mp4,stream=video,output=h264_1080p.mp4 \
  --mpd_output h264.mpd

```
Tokens:
Raw