From 5cdba707602cbb49bfcbcae0de68e6d619b624f2 Mon Sep 17 00:00:00 2001 From: imSp4rky Date: Thu, 20 Aug 2026 18:50:03 -0600 Subject: [PATCH] docs: widen supported shaka-packager range to 2.6.1 or >= 3.10.0 --- README.md | 2 +- docs/getting-started/installation.md | 7 ++++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a7b4c693..2c350049 100644 --- a/README.md +++ b/README.md @@ -42,7 +42,7 @@ External tools. (recommended versions): - [uv](https://docs.astral.sh/uv/) - ≥ 0.5 - [FFmpeg](https://ffmpeg.org/) - ≥ 6.0 - [MKVToolNix](https://mkvtoolnix.download/) - ≥ 80 -- [shaka-packager](https://github.com/shaka-project/shaka-packager/releases/tag/v2.6.1) - 2.6.1 +- [shaka-packager](https://github.com/shaka-project/shaka-packager/releases) - 2.6.1, or ≥ 3.10.0 Optional: diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index 8155ca98..8147774e 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -19,7 +19,7 @@ version it needs, and the external command-line tools it expects to find on your | [uv](https://docs.astral.sh/uv/) | ≥ 0.5 | Installing and running unshackle | | [FFmpeg](https://ffmpeg.org/) | ≥ 6.0 | Media processing and analysis | | [MKVToolNix](https://mkvtoolnix.download/) | ≥ 80 | MKV muxing and metadata editing | -| [shaka-packager](https://github.com/shaka-project/shaka-packager) | 2.6.1 | DRM decryption | +| [shaka-packager](https://github.com/shaka-project/shaka-packager) | 2.6.1, or ≥ 3.10.0 | DRM decryption | | [Bento4](https://github.com/axiomatic-systems/Bento4) | ≥ 1.6.0-639 | Alternate DRM decryption (`mp4decrypt`) | | [dovi_tool](https://github.com/quietvoid/dovi_tool) | ≥ 2.1 | Dolby Vision handling | | [SubtitleEdit](https://github.com/SubtitleEdit/subtitleedit/releases) | ≥ 5.0 | Subtitle conversion (optional) | @@ -111,6 +111,11 @@ These must be present for core downloading, decryption, and muxing to work: decryption step. See the [configuration reference](../reference/configuration/drm.md#decryption) for the `decryption` config key if you want to switch to `mp4decrypt`. +!!! danger "Do not use shaka-packager 3.0 through 3.9.x" + These versions stop with a segmentation fault on a single-track MP4 whose + internal `track_id` is 2 or more. A track that unshackle downloads from a + DASH or HLS manifest usually has such a `track_id`. + ### Recommended and optional tools These extend unshackle's capabilities. Install the ones relevant to what you