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

feat(export): write mediaexport files and read legacy exports through the package

Browse Source 
--export writes the mediaexport format with DRM, content keys and manifests at title level, and unshackle's own track dicts under x-unshackle. unshackle import reads mediaexport, unidl v1 and unshackle v2 through the shared reader, applies the export's request headers to the import session, and rebuilds DRM from the title-level pool. mediaexport is a git dependency on unshackle-dl/mediaexport.
This commit is contained in:
imSp4rky
2026-09-20 00:07:04 -06:00
parent 70c3a05552
commit 746385101b
8 changed files with 297 additions and 110 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/guide/downloading.md
+15 -3
View File
@@ -771,14 +771,26 @@ a content key when the vault misses. You can force one side or the other:
unshackle dl --skip-dl EXAMPLE 81234567
```
`--export` writes a JSON file, into the configured exports directory, containing track
info and the acquired content keys for each title. This is the format consumed by
`unshackle import` to reconstruct a download later.
`--export` writes a `mediaexport` JSON file into the configured exports directory. It holds
the manifest, the DRM init data, the content keys and the title metadata for each title.
`unshackle import` reads it to reconstruct a download later. The importer also reads the
older unshackle `version: 2` files and unidl's own export files.
```shell title="Export track info and keys"
unshackle dl --skip-dl --export EXAMPLE 81234567
```
The export holds a content key for each track your flags selected and no others. To make a
file another person can use, select generously: for example `-a AAC,EC3` and every language
you want them to have. An import can only pick tracks whose key is in the file.
!!! warning "The export file is a secret"
It holds the content keys and usually a signed manifest URL. Hand it over on purpose,
not by accident.
The [mediaexport](https://github.com/unshackle-dl/mediaexport) package specifies the
`mediaexport` format and is the reader and writer unshackle uses.
!!! note "Region is recorded only with a proxy"
When you use `--proxy`, the export records the region so an import can reproduce the
correct geofence. Without a proxy, the export stores no region.