A media packaging and development framework for VOD and Live DASH and HLS applications, supporting Common Encryption for Widevine and other DRM Systems.

Go to file

Caitlin O'Callaghan f264befe86 feat: Write colr atom to muxed mp4 (#1261 ) This PR is an extension of the full AV1 codec string feature: [PR 1205](https://github.com/shaka-project/shaka-packager/pull/1205) and relates to [Issue 1007](https://github.com/shaka-project/shaka-packager/issues/1007) and [Issue 1202](https://github.com/shaka-project/shaka-packager/issues/1202). As per the AV1 spec, the codec string may contain optional color values. These color values are critical for detecting HDR video streams - see [Issue 1007](https://github.com/shaka-project/shaka-packager/issues/1007). Color information is extracted from the input mp4's `colr` atom and used to generate the full AV1 codec string. This PR preserves the color information by writing the `colr` atom to the muxed mp4. References: - [AV1 Codec ISO Media File Format Binding](https://aomediacodec.github.io/av1-isobmff/#codecsparam) - [AV1 Bitstream & Decoding Process Specification - Section 6.4.2 Color config semantics (page 117)](https://aomediacodec.github.io/av1-spec/av1-spec.pdf) - [QuickTime File Format Specification](https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFChap3/qtff3.html#//apple_ref/doc/uid/TP40000939-CH205-125526)		2023-08-29 18:46:19 -07:00
.github	chore: Sync common workflows (#1250 )	2023-07-24 17:17:54 -07:00
docs	docs: Update build_instructions.md to point to the `main` branch. (#1186 )	2023-07-05 14:31:39 -07:00
npm	chore: Update URLs after moving projects (#1042 )	2022-03-07 11:56:34 -08:00
packager	feat: Write colr atom to muxed mp4 (#1261 )	2023-08-29 18:46:19 -07:00
.clang-format	Use Chromium style for clang-format	2014-07-02 22:49:46 +00:00
.dockerignore	Reduce Docker image size	2018-12-20 13:31:03 -08:00
.gitignore	HTTP PUT output support (#737 )	2021-02-02 10:51:50 -08:00
.gitmodules	Add an empty .gitmodules to avoid gclient warning	2014-03-28 22:13:33 +00:00
AUTHORS	fix: Fix handling of non-interleaved multi track FMP4 files (#1214 )	2023-08-21 16:34:32 -07:00
CHANGELOG.md	chore: Update URLs after moving projects (#1042 )	2022-03-07 11:56:34 -08:00
CONTRIBUTING.md	Add AUTHORS, CONTRIBUTORS, CONTRIBUTING.md, and README.md	2014-04-19 00:05:38 +00:00
CONTRIBUTORS	fix: Fix handling of non-interleaved multi track FMP4 files (#1214 )	2023-08-21 16:34:32 -07:00
DEPS	build: Fix builds with CC=clang CXX=clang++	2021-08-14 11:07:36 -07:00
Dockerfile	fix: Roll back depot_tools, bypass vpython (#1045 )	2022-03-08 16:46:18 -08:00
LICENSE	Update README and LICENSE	2016-09-07 19:22:41 +00:00
README.md	docs: Deprecate the mailing list for releases (#1071 )	2022-06-28 09:58:17 -07:00
chromium-LICENSE	Add Chromium license	2014-04-10 19:58:08 +00:00
gyp_packager.py	build: Fix pylint 2.10 issues, use python3 where possible	2021-08-24 12:27:03 -07:00

README.md

Shaka Packager is a tool and a media packaging SDK for DASH and HLS packaging and encryption. It can prepare and package media content for online streaming.

Shaka Packager supports:

Both Video-On-Demand and Live.
Streaming formats:
- DASH
- HLS
Key systems:
- Widevine
- PlayReady¹
- FairPlay¹
- Marlin¹
Encryption standards:
- CENC
- SAMPLE-AES

Media Containers and codecs

Codecs	ISO-BMFF	WebM	MPEG2-TS	WVM	Packed Audio²
H264 (AVC)	I / O	-	I / O	I	-
H265 (HEVC)	I / O	-	I	-	-
VP8	I / O	I / O	-	-	-
VP9	I / O	I / O	-	-	-
AV1	I / O	I / O	-	-	-
AAC	I / O	-	I / O	I	O
MP3	O	-	I / O	-	O
Dolby AC3	I / O	-	I / O	-	O
Dolby EAC3	I / O	-	O	-	O
MPEG-H Audio	I / O	-	-	-	-
Dolby AC4	I / O	-	-	-	-
DTS	I / O	-	-	-	-
FLAC	I / O	-	-	-	-
Opus	I / O³	I / O	-	-	-
Vorbis	-	I / O	-	-	-

NOTES:

I for input and O for output.
²: https://tools.ietf.org/html/draft-pantos-http-live-streaming-23#section-3.4
³: Opus support in ISO-BMFF is experimental.

Subtitles

Format Input Output

Text WebVTT Y Y

WebVTT in MP4 #405 Y

Text TTML ⁴ Y

TTML in MP4 - Y

DVB-SUB Y -

Teletext #272 -
- ⁴: TTML input is only supported with TTML output (pass-through, DASH only), see also #584.

Format	Input	Output
Text WebVTT	Y	Y
WebVTT in MP4	#405	Y
Text TTML	⁴	Y
TTML in MP4	-	Y
DVB-SUB	Y	-
Teletext	#272	-

Platforms
- Linux
- Mac
- Windows
- Cross compiling for ARM is also supported.

^{1: Limited support}

Getting Shaka Packager

There are several ways you can get Shaka Packager.

Using Docker. Instructions are available here.
Get prebuilt binaries from release.
Built from source, see Build Instructions for details.

Useful Links

Announcement List (join for infrequent announcements and surveys)
Subscribe to releases by following instructions from this blog- Documentation
Tutorials
Several open source players:

Contributing

If you have improvements or fixes, we would love to have your contributions. See https://github.com/shaka-project/shaka-packager/blob/main/CONTRIBUTING.md for details.