mirror of https://github.com/shaka-project/shaka-packager.git synced 2026-04-02 11:20:08 +00:00

Go to file

Xavier Laffargue 3aafed82b6 feat: Add signaling for CEA-608/708 captions (#1532 )

This change introduces support for signaling CEA-608 and CEA-708 closed
captions in HLS.

New command-line flags, `--closed_captions`, have been added to allow
users to specify the caption tracks. The format for these flags is a
comma-separated list of semicolon-separated key-value pairs, e.g.,

`--closed_captions

"channel=CC1,name=French,lang=fra,default=no,autoselect=yes;channel=SERVICE1,name=English,lang=eng,default=yes,autoselect=yes"`.

For HLS, this change adds `#EXT-X-MEDIA` tags for each caption track
with a common `GROUP-ID` of "cc". The `EXT-X-STREAM-INF` tag for video
streams has been updated to reference this `GROUP-ID`.

Dash will be supported in another PR.

Fixes #986

2026-03-04 17:08:33 -08:00

.github

fix(ci): Update release for trusted publishing to NPM (#1544 )

2026-03-04 13:30:04 -08:00

docs

feat: EXT-X-SESSION-KEY support (#36 ) (#1427 )

2024-10-25 09:55:27 -07:00

include

feat: Add signaling for CEA-608/708 captions (#1532 )

2026-03-04 17:08:33 -08:00

link-test

build: turn on integration tests in ctest by default (#1381 )

2024-04-19 07:56:49 -07:00

npm

fix: Fix NPM binary selection on ARM Macs (#1376 )

2024-03-20 20:22:29 -07:00

packager

feat: Add signaling for CEA-608/708 captions (#1532 )

2026-03-04 17:08:33 -08:00

.clang-format

…

.dockerignore

…

.gitignore

feat!: Rewrite build system and third-party dependencies (#1310 )

2023-12-01 09:32:19 -08:00

.gitmodules

feat: Portable, fully-static release executables on Linux (#1351 )

2024-02-27 10:47:04 -08:00

.release-please-config.json

ci: Update actions (#1360 )

2024-03-05 09:28:51 -08:00

.release-please-manifest.json

chore(main): release 3.4.2 (#1473 )

2025-01-17 14:19:28 -08:00

AUTHORS

fix: Add Missing Dash Roles to RoleFromString function (#1418 ) (#1419 )

2024-08-28 18:59:57 -07:00

build-matrix.json

fix(ci): Update release for trusted publishing to NPM (#1544 )

2026-03-04 13:30:04 -08:00

CHANGELOG.md

chore(main): release 3.4.2 (#1473 )

2025-01-17 14:19:28 -08:00

chromium-LICENSE

feat!: Rewrite build system and third-party dependencies (#1310 )

2023-12-01 09:32:19 -08:00

CMakeLists.txt

build: turn on integration tests in ctest by default (#1381 )

2024-04-19 07:56:49 -07:00

CODE_OF_CONDUCT.md

chore: Sync policy documents (#1467 )

2024-12-20 13:54:49 -08:00

CONTRIBUTING.md

…

CONTRIBUTORS

fix: Fix color range info loss in WebM input to init mp4 packaging (#1517 )

2026-03-04 14:47:22 -08:00

Dockerfile

chore: upgrade to alpine 3.19 (#1327 )

2024-02-10 09:25:37 -08:00

LICENSE

feat!: Rewrite build system and third-party dependencies (#1310 )

2023-12-01 09:32:19 -08:00

README.md

feat: Add IAMF support (#1415 ) (#1416 )

2024-10-25 09:56:28 -07:00

SECURITY.md

chore: Sync policy documents (#1467 )

2024-12-20 13:54:49 -08: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	-	-	-
IAMF	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.