feat(manifests): add dts-hd, mpeg-h and lcevc codecs and a manifest corpus

Fix DASH SegmentTimeline negative @r and Pattern, TTML sidecar sets with no contentType, HLS CHANNELS identifiers and Dolby channel masks; test against 408 public DASH/HLS/ISM manifests.

docs/dev/service-architecture.md

@@ -284,7 +284,7 @@ do not give a `name`, unshackle derives a human-readable name from the language.
 `Video` adds `codec`, `range`, `bitrate`, `width`, `height`, `fps`, `scan_type`, and
 closed-caption descriptors. The relevant enums:
 
-- **`Video.Codec`**: `AVC` (H.264), `HEVC` (H.265), `VC1`, `VP8`, `VP9`, `AV1`.
+- **`Video.Codec`**: `AVC` (H.264), `HEVC` (H.265), `VC1`, `VP8`, `VP9`, `AV1`, `LCEVC`.
 - **`Video.Range`**: `SDR`, `HLG`, `HDR10`, `HDR10P` (HDR10+), `DV` (Dolby Vision), and
   `HYBRID`. `HYBRID` is special: it tells the pipeline to select both an HDR10(+) base and
   a DV track and merge the DV RPU onto the HDR10 track with `dovi_tool` (see
@@ -298,7 +298,7 @@ closed-caption descriptors. The relevant enums:
 
 `Audio` adds `bitrate`, `channels`, `joc` (Joint Object Coding, the Atmos indicator),
 and `descriptive`. `Audio.Codec` covers `AAC`, `AC3` (`DD`), `EC3` (`DD+`), `AC4`,
-`OPUS`, `OGG` (Vorbis), `DTS`, `DTSX`, `ALAC`, and `FLAC`. The `atmos` property is `True` when
+`OPUS`, `OGG` (Vorbis), `DTS`, `DTSX`, `DTSHD`, `MPEGH`, `ALAC`, and `FLAC`. The `atmos` property is `True` when
 `joc` is set (or when `extra` flags it).
 
 ### `Subtitle`

docs/getting-started/installation.md

@@ -268,7 +268,7 @@ download. For example, `dovi_tool` only matters if you download Dolby Vision vid
 | Tool | Binary looked up | Why it is needed |
 | --- | --- | --- |
 | Bento4 (`mp4decrypt`) | `mp4decrypt` | Alternative DRM decryptor to shaka-packager |
-| MP4Box (GPAC) | `MP4Box` | Muxing DTS:X Profile 2 (DTS-UHD) audio |
+| MP4Box (GPAC) | `MP4Box` | Muxing DTS:X Profile 2 (DTS-UHD) and MPEG-H audio |
 | dovi_tool | `dovi_tool` | Dolby Vision metadata handling |
 | HDR10Plus_tool | `hdr10plus_tool` | HDR10+ metadata handling |
 | SubtitleEdit | `seconv`, `SubtitleEdit` | Subtitle conversion (the `SeConv` CLI from 5.x) |
@@ -280,8 +280,8 @@ download. For example, `dovi_tool` only matters if you download Dolby Vision vid
 | Docker | `docker` | Gluetun VPN proxy support |
 | Git | `git` | Fetching and updating remote service repositories |
 
-!!! info "MP4Box is only used for DTS:X Profile 2"
-    Titles with DTS:X Profile 2 (DTS-UHD) audio mux to MP4; everything else muxes to MKV
+!!! info "MP4Box is only used for DTS:X Profile 2 and MPEG-H"
+    Titles with DTS:X Profile 2 (DTS-UHD) or MPEG-H audio mux to MP4; everything else muxes to MKV
     with `mkvmerge`. Install with `apt install gpac`.
 
 !!! tip "SubtitleEdit specifics"

docs/guide/downloading.md

@@ -119,9 +119,13 @@ either enum **names** or their **values**, comma-separated.
 | `VP8` | `VP8` |
 | `VP9` | `VP9` |
 | `AV1` | `AV1` |
+| `LCEVC` | `LCEVC` |
 
 `H264` and `H265` are aliases of `AVC` and `HEVC`.
 
+An LCEVC (MPEG-5 Part 2) track only adds detail on top of its base video track and cannot play
+alone, so unshackle selects it only when you ask for it with `-v LCEVC`.
+
 ```shell title="Either spelling works"
 unshackle dl -v HEVC   EXAMPLE 81234567
 unshackle dl -v H.265  EXAMPLE 81234567
@@ -280,6 +284,8 @@ bitrate for the top renditions, overriding the manifest value:
 | `OGG` | `VORB` | Vorbis |
 | `DTS` | `DTS` | DTS |
 | `DTSX` | `DTS-X` | DTS:X Profile 2 (DTS-UHD) |
+| `DTSHD` | `DTS-HD` | DTS-HD High Resolution, Master Audio and Express |
+| `MPEGH` | `MPEG-H` | MPEG-H 3D Audio |
 | `ALAC` | `ALAC` | Apple Lossless |
 | `FLAC` | `FLAC` | FLAC |
 

docs/guide/output-and-naming.md

@@ -15,7 +15,7 @@ When a download finishes, unshackle builds the final path from three pieces:
 - **Output directory**: `directories.downloads` from your config, or whatever you pass to `-o/--output` on the command line for a single run.
 - **Folder template**: an optional per-title subfolder. unshackle **always** puts TV episodes and songs in a folder. Movies only get one if you define a `movies` folder template, or a single-string `folder` template that applies to all title kinds (see [Folder templates](#folder-templates)).
 - **Filename template**: the `output_template` for the title kind (movie, series, or song).
-- **Extension**: chosen by the muxer for a movie or an episode: `.mkv` for video, `.mka` for audio-only, `.mks` for subtitle-only, `.mp4` for [DTS:X Profile 2 audio](#dtsx-profile-2-output). unshackle does not mux a song. It remuxes a song into the container of its codec, such as `.flac`, `.opus`, or `.m4a`. Read [Music output files](#music-output-files).
+- **Extension**: chosen by the muxer for a movie or an episode: `.mkv` for video, `.mka` for audio-only, `.mks` for subtitle-only, `.mp4` for [DTS:X Profile 2 and MPEG-H audio](#dtsx-profile-2-and-mpeg-h-output). unshackle does not mux a song. It remuxes a song into the container of its codec, such as `.flac`, `.opus`, or `.m4a`. Read [Music output files](#music-output-files).
 
 !!! example "A typical episode path"
     ```text
@@ -359,11 +359,12 @@ name `Original` or `Japanese (original)` stays as it is.
     out the language when the name already contains it, so an English name shows once. A native name
     such as `日本語` shows next to `Japanese` in an English interface.
 
-### DTS:X Profile 2 output
+### DTS:X Profile 2 and MPEG-H output
 
-A title whose audio holds a `dtsx` or `dtsy` sample entry (DTS:X Profile 2, DTS-UHD) muxes
-to MP4 with [MP4Box](../getting-started/installation.md), because Matroska has no CodecID
-for it. Without MP4Box installed the mux stops.
+A title whose audio holds a `dtsx` or `dtsy` sample entry (DTS:X Profile 2, DTS-UHD), or an
+MPEG-H sample entry (`mha1`, `mha2`, `mhm1`, `mhm2`), muxes to MP4 with
+[MP4Box](../getting-started/installation.md), because Matroska has no CodecID for it.
+Without MP4Box installed the mux stops.
 
 DTS:X Profile 1 is DTS-HD Master Audio and muxes to MKV as usual.