kenzuya/unshackle
1
0
Fork 2
mirror of https://github.com/unshackle-dl/unshackle.git synced 2026-11-12 12:05:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(dl): add cross-service muxing

Browse Source 
Take video, audio, subtitles, or chapters from other services and mux them
with the primary download. Each cross-service authenticates, licenses, and
decrypts with its own CDM, key vault, and proxy. Audio and subtitles merge
with the primary's tracks (video and chapters replace) and flow through the
normal best-per-language selection, with an id-namespace guard so a cross
track can never shadow a primary track's DRM routing.

Per-source offsets emit an mkvmerge --sync argument; episodes auto-match with
per-type --cross-*-wanted overrides. Adds unit and offline end-to-end tests
and a cross-service muxing guide.
This commit is contained in:
imSp4rky
2026-08-05 15:56:23 -06:00
parent 02fd7b9387
commit 5bc92b5517
8 changed files with 1010 additions and 75 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/guide/cli-reference.md
+37
View File
@@ -146,6 +146,43 @@ Keep only certain track types, or skip certain track types. Attachments are alwa
| `--tag` | Group tag override. |
| `--repack` | Add a `REPACK` tag to the filename. |
### Cross-service muxing
Take some track types from a different service and mux them with the rest. Each `--cross-*` flag
takes a service tag and a URL. Video and chapters replace what the service you download provides;
audio and subtitles are merged in, so the best-per-language selection runs across both services'
tracks together. See [Cross-service muxing](cross-service-muxing.md) for the full guide.
| Flag | Description |
|---|---|
| `--cross-video` | Take video tracks from `SERVICE URL` (replaces the download service's video). |
| `--cross-audio` | Merge in audio tracks from `SERVICE URL`. |
| `--cross-subtitles` | Merge in subtitle tracks from `SERVICE URL`. |
| `--cross-chapters` | Take chapters from `SERVICE URL` (replaces the download service's chapters). |
| `--cross-audio-offset` | Shift the cross-sourced audio in the mux, e.g. `10s`, `500ms`, `-5.5s`. A bare number is milliseconds. |
| `--cross-subtitle-offset` | Shift the cross-sourced subtitles in the mux. Same format as above. |
| `--cross-profile` | Profile used for the cross-service credentials. Defaults to `--profile`. |
| `--cross-proxy` | Proxy for every cross-service. Overrides each cross-service's own proxy configuration. |
| `--cross-wanted` | Episode to take from the cross-services, e.g. `S01E02`. Fallback for the per-type flags below. Defaults to the same season and episode as the title you download. |
| `--cross-video-wanted` | Episode to take video from, e.g. `S01E02`. Overrides `--cross-wanted` for video. |
| `--cross-audio-wanted` | Episode to take audio from. Overrides `--cross-wanted` for audio. |
| `--cross-subtitles-wanted` | Episode to take subtitles from. Overrides `--cross-wanted` for subtitles. |
| `--cross-chapters-wanted` | Episode to take chapters from. Overrides `--cross-wanted` for chapters. |
```bash
unshackle dl --cross-audio EXAMPLE2 "https://example2.com/show/1" EXAMPLE "https://example.com/show/1"
```
Each cross-service authenticates, licenses and decrypts its own tracks with its own CDM, key
vaults and (unless `--cross-proxy` is set) its own proxy, so you need credentials for it as well.
Offsets are applied by the muxer, which does not re-time the media itself.
!!! note "Titles must match"
For a series, unshackle looks for the same season and episode number on the cross-service.
Use `--cross-wanted` (or a per-type flag such as `--cross-audio-wanted`) when the two services
number the episodes differently. If no title matches, unshackle logs a warning and keeps the
tracks of the service you download.
### Metadata & tagging
| Flag | Description |