mirror of
https://github.com/unshackle-dl/unshackle.git
synced 2026-11-12 20:15:10 +00:00
Deployed d014c69 with MkDocs version: 1.6.1
This commit is contained in:
@@ -3338,7 +3338,7 @@ and keeps the service's numbering unchanged. Pick an order that covers the whole
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>--export</code></td>
|
||||
<td>Export track info and keys to a JSON file in the exports directory.</td>
|
||||
<td>Export track info and keys to a <code>mediaexport</code> JSON file in the exports directory.</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@@ -3490,7 +3490,7 @@ and keeps the service's numbering unchanged. Pick an order that covers the whole
|
||||
</span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>unshackle<span class="w"> </span>import<span class="w"> </span>export.json<span class="w"> </span>-r<span class="w"> </span>HDR10<span class="w"> </span>--proxy<span class="w"> </span>US
|
||||
</span></code></pre></div>
|
||||
</div>
|
||||
<p>The export file must be a valid v2 export from a current version of unshackle, made with <code>dl --export</code>, and must contain a <code>service</code> tag.</p>
|
||||
<p>The export file can be a <code>mediaexport</code> file from <code>dl --export</code>, an export from an older version of unshackle, or an export from unidl. The file must name the service it came from.</p>
|
||||
<hr />
|
||||
<h2 id="cfg"><code>cfg</code><a class="headerlink" href="#cfg" title="Permanent link">¶</a></h2>
|
||||
<p>Read, set, delete, or show configuration values in <code>unshackle.yaml</code> without hand-editing YAML.</p>
|
||||
|
||||
@@ -3977,15 +3977,62 @@ a content key when the vault misses. You can force one side or the other:</p>
|
||||
<div class="language-shell highlight"><span class="filename">Fetch keys only, no download</span><pre><span></span><code><span id="__span-42-1"><a id="__codelineno-42-1" name="__codelineno-42-1" href="#__codelineno-42-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>--skip-dl<span class="w"> </span>EXAMPLE<span class="w"> </span><span class="m">81234567</span>
|
||||
</span></code></pre></div>
|
||||
<p><code>--export</code> writes a <code>mediaexport</code> 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.
|
||||
<code>unshackle import</code> reads it to reconstruct a download later. The importer also reads the
|
||||
the manifest, the DRM init data, the content keys, the KIDs of each track and the title
|
||||
metadata for each title. <code>unshackle import</code> reads it to reconstruct a download later, and gives
|
||||
each track only the content keys for its KIDs. The importer also reads the
|
||||
older unshackle <code>version: 2</code> files and unidl's own export files.</p>
|
||||
<div class="language-shell highlight"><span class="filename">Export track info and keys</span><pre><span></span><code><span id="__span-43-1"><a id="__codelineno-43-1" name="__codelineno-43-1" href="#__codelineno-43-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>--skip-dl<span class="w"> </span>--export<span class="w"> </span>EXAMPLE<span class="w"> </span><span class="m">81234567</span>
|
||||
</span></code></pre></div>
|
||||
<p>The file name tells what the file holds, in the form
|
||||
<code>{title}.{scope}.{resolutions}.{codecs}.{ranges}.{manifests}.{audio}-{SERVICE}.json</code>:</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Export</th>
|
||||
<th>File name</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>A movie</td>
|
||||
<td><code>Example.Movie.2024.1080p.h264.sdr.hls.aac2.0-EXAMPLE.json</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>A whole season</td>
|
||||
<td><code>Example.Show.S01.2160p.h265.sdr.hdr10.dash.dd5.1-EXAMPLE.json</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Episodes 5 to 9 and 12</td>
|
||||
<td><code>Example.Show.S01E05-E09.S01E12.1080p.h264.sdr.dash.aac2.0-EXAMPLE.json</code></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<ul>
|
||||
<li>A dot separates each part and each word of the title. The name has no spaces or
|
||||
underscores. It does not follow your <code>output_template</code>: a template with spaces does not
|
||||
change the export name.</li>
|
||||
<li>The scope is <code>S01</code> only when the file holds every episode the service lists for that season.
|
||||
Otherwise it names each run of episodes. Whole seasons in a row become <code>S01-S03</code>. After three
|
||||
parts, <code>+N</code> counts the parts left out. A movie has no scope.</li>
|
||||
<li>The quality parts come from the video and audio tracks selected for the titles in the file.
|
||||
Each value shows once.</li>
|
||||
<li>unshackle renames the file after each write, so the name always matches what the file holds.
|
||||
When a run stops early, the file is complete for the titles it holds.</li>
|
||||
<li>When another file already has the name, unshackle adds <code>-2</code>, <code>-3</code>, and so on. It never
|
||||
writes over another export.</li>
|
||||
</ul>
|
||||
<p>The run logs the file name at the first write, the track and content key counts for each title, and
|
||||
at the end the path and the total counts.</p>
|
||||
<p>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 <code>-a AAC,EC3</code> and every language
|
||||
you want them to have. An import can only pick tracks whose key is in the file. A subtitle
|
||||
that another tool exported as a direct URL is added next to the manifest's own.</p>
|
||||
you want them to have. An import can only pick tracks whose key is in the file. A track
|
||||
that another tool exported as a direct file URL is added next to the manifest's own tracks.
|
||||
An export with no manifest, for example a unidl export of whole media files, gets all of its
|
||||
tracks from those URLs. If such an export does not give the title a language, <code>orig</code> has no
|
||||
value: select the languages with <code>-l</code> and <code>-vl</code>.</p>
|
||||
<p>An import uses only the content keys in the file and in your vaults. It never gets a licence
|
||||
from a CDM. When a track needs a content key that neither has, the import stops and names the
|
||||
KID. To fix this, export the title again with that track selected.</p>
|
||||
<div class="admonition warning">
|
||||
<p class="admonition-title">The export file is a secret</p>
|
||||
<p>It holds the content keys and usually a signed manifest URL. Hand it over on purpose,
|
||||
|
||||
BIN
Binary file not shown.
@@ -2420,6 +2420,17 @@
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.PlayReady.own_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code> own_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
@@ -2619,6 +2630,17 @@
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.Widevine.own_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code> own_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
@@ -2668,6 +2690,28 @@
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.real_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-function"></code> real_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.own_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-function"></code> own_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
@@ -3214,6 +3258,17 @@
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.PlayReady.own_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code> own_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
@@ -3413,6 +3468,17 @@
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.Widevine.own_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-method"></code> own_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
@@ -3462,6 +3528,28 @@
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.real_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-function"></code> real_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#unshackle.core.drm.own_kids" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
<code class="doc-symbol doc-symbol-toc doc-symbol-function"></code> own_kids
|
||||
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
@@ -5156,6 +5244,28 @@ Raises:
|
||||
<div class="doc doc-object doc-function">
|
||||
|
||||
|
||||
<h3 id="unshackle.core.drm.PlayReady.own_kids" class="doc doc-heading">
|
||||
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">own_kids</span>
|
||||
|
||||
|
||||
<a href="#unshackle.core.drm.PlayReady.own_kids" class="headerlink" title="Permanent link">¶</a></h3>
|
||||
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">own_kids</span><span class="p">()</span>
|
||||
</span></code></pre></div>
|
||||
|
||||
<div class="doc doc-contents ">
|
||||
|
||||
<p>Return the KIDs that identify this track's own content key.</p>
|
||||
<p>The KID given to the constructor (from the manifest or the init segment) names the
|
||||
track exactly. A PSSH can name the KIDs of other renditions too.</p>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="doc doc-object doc-function">
|
||||
|
||||
|
||||
<h3 id="unshackle.core.drm.PlayReady.mp4decrypt_key_args" class="doc doc-heading">
|
||||
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">mp4decrypt_key_args</span>
|
||||
|
||||
@@ -5166,7 +5276,7 @@ Raises:
|
||||
|
||||
<div class="doc doc-contents ">
|
||||
|
||||
<p>Build the mp4decrypt --key arguments for every content key.</p>
|
||||
<p>Build the mp4decrypt --key arguments for every content key and the zero-KID fallback.</p>
|
||||
|
||||
|
||||
</div>
|
||||
@@ -5696,6 +5806,28 @@ Raises:
|
||||
<div class="doc doc-object doc-function">
|
||||
|
||||
|
||||
<h3 id="unshackle.core.drm.Widevine.own_kids" class="doc doc-heading">
|
||||
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">own_kids</span>
|
||||
|
||||
|
||||
<a href="#unshackle.core.drm.Widevine.own_kids" class="headerlink" title="Permanent link">¶</a></h3>
|
||||
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">own_kids</span><span class="p">()</span>
|
||||
</span></code></pre></div>
|
||||
|
||||
<div class="doc doc-contents ">
|
||||
|
||||
<p>Return the KIDs that identify this track's own content key.</p>
|
||||
<p>The KID given to the constructor (from the manifest or the init segment) names the
|
||||
track exactly. A PSSH can name the KIDs of other renditions too.</p>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="doc doc-object doc-function">
|
||||
|
||||
|
||||
<h3 id="unshackle.core.drm.Widevine.mp4decrypt_key_args" class="doc doc-heading">
|
||||
<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code> <span class="doc doc-object-name doc-function-name">mp4decrypt_key_args</span>
|
||||
|
||||
@@ -5706,7 +5838,7 @@ Raises:
|
||||
|
||||
<div class="doc doc-contents ">
|
||||
|
||||
<p>Build the mp4decrypt --key arguments for every content key.</p>
|
||||
<p>Build the mp4decrypt --key arguments for every content key and the zero-KID fallback.</p>
|
||||
|
||||
|
||||
</div>
|
||||
@@ -5785,6 +5917,46 @@ contacting a license server.</p>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="doc doc-object doc-function">
|
||||
|
||||
|
||||
<h2 id="unshackle.core.drm.real_kids" class="doc doc-heading">
|
||||
<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code> <span class="doc doc-object-name doc-function-name">real_kids</span>
|
||||
|
||||
|
||||
<a href="#unshackle.core.drm.real_kids" class="headerlink" title="Permanent link">¶</a></h2>
|
||||
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">real_kids</span><span class="p">(</span><span class="n">drm</span><span class="p">)</span>
|
||||
</span></code></pre></div>
|
||||
|
||||
<div class="doc doc-contents ">
|
||||
|
||||
<p>Return the KIDs a DRM object names, without the all-zero and test-pattern placeholders.</p>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="doc doc-object doc-function">
|
||||
|
||||
|
||||
<h2 id="unshackle.core.drm.own_kids" class="doc doc-heading">
|
||||
<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code> <span class="doc doc-object-name doc-function-name">own_kids</span>
|
||||
|
||||
|
||||
<a href="#unshackle.core.drm.own_kids" class="headerlink" title="Permanent link">¶</a></h2>
|
||||
<div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">own_kids</span><span class="p">(</span><span class="n">drm</span><span class="p">)</span>
|
||||
</span></code></pre></div>
|
||||
|
||||
<div class="doc doc-contents ">
|
||||
|
||||
<p>Return the real KIDs that identify the track's own content key, as the DRM object knows them.</p>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user