mirror of
https://github.com/unshackle-dl/unshackle.git
synced 2026-11-14 21:15:06 +00:00
Deployed 4b6d15cc with MkDocs version: 1.6.1
This commit is contained in:
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -3092,7 +3092,7 @@
|
||||
<tr>
|
||||
<td><code>--best-available</code>, <code>--warn-only</code></td>
|
||||
<td>off</td>
|
||||
<td>Warn and continue when a requested resolution, range, or language is absent, instead of failing. With <code>--all-drm</code>, also when one DRM system does not license.</td>
|
||||
<td>Warn and continue when a requested resolution, range, video language, or audio language is absent, instead of failing. With <code>--all-drm</code>, also when one DRM system does not license.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>-rvb</code>, <code>--real-video-bitrate</code></td>
|
||||
@@ -4255,7 +4255,7 @@ through the tunnel. It stops at the first step that fails.</p>
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -3206,7 +3206,7 @@ therefore keeps its <code>3840×1920</code> HDR10 track, even when another range
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code>--best-available</code> (<code>--warn-only</code>)</td>
|
||||
<td>If the requested resolution(s) are not present, continue with the best that <em>is</em> available instead of failing. Also softens missing video/audio/subtitle languages and hybrid fallbacks, and with <code>--all-drm</code> a DRM system that does not license.</td>
|
||||
<td>If the requested resolution(s) are not present, continue with the best that <em>is</em> available instead of failing. Also softens missing video and audio languages and hybrid fallbacks, and with <code>--all-drm</code> a DRM system that does not license.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>--worst</code></td>
|
||||
@@ -3632,7 +3632,8 @@ selects <code>pt-BR</code>. If the title has no such variant, the tag takes ever
|
||||
<code>-l es</code> on a title with only <code>es-419</code> selects <code>es-419</code>.</p>
|
||||
<p>A tag with a region asks for that variant only: <code>-l es-419</code> selects <code>es-419</code>, never <code>es-ES</code>
|
||||
or <code>es-MX</code>. If the service has no <code>es-419</code> track, unshackle reports <code>es-419 not found</code> and
|
||||
stops. With <code>--best-available</code>, it continues with the other languages.</p>
|
||||
stops. With <code>--best-available</code>, it continues with the other languages. A missing <code>-sl</code>
|
||||
language always gives a warning and the download continues; <code>--require-subs</code> makes it fail.</p>
|
||||
<p>A track without a region matches only the region its language implies. <code>en</code> is US English
|
||||
and <code>pt</code> is Brazilian Portuguese, so <code>-l en-US</code> accepts a track tagged <code>en</code>, but <code>-l en-GB</code>
|
||||
and <code>-l pt-PT</code> do not accept <code>en</code> or <code>pt</code>. To take any English track, write <code>en</code>.</p>
|
||||
@@ -4754,7 +4755,7 @@ authoritative list.</p>
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -3265,7 +3265,7 @@ Treat those logs as sensitive. The unrelated <code>redact_paths</code> option (d
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -3760,7 +3760,7 @@ empty on disc 1, so <code>{disc?}</code> and its separator only appear from disc
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -4099,7 +4099,7 @@ friendly connection line instead of the raw proxy URL.</p>
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -2584,7 +2584,7 @@ format-appropriate clean-up to make a single, valid file:</p>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>--require-subs</code></td>
|
||||
<td>Require these languages to exist; if present, download <strong>all</strong> subtitles. Cannot be combined with <code>--s-lang</code>.</td>
|
||||
<td>Require these languages to exist. The title fails if one is missing. <code>--s-lang</code> still decides what to keep.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>-fs</code>, <code>--forced-subs</code></td>
|
||||
@@ -2630,21 +2630,16 @@ regional form only when the title has no such variant. A tag with a region match
|
||||
that variant:</p>
|
||||
<div class="language-shell highlight"><span class="filename">Only Latin-American Spanish, no other Spanish variants</span><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>--s-lang<span class="w"> </span>es-419<span class="w"> </span>EXAMPLE<span class="w"> </span><span class="s1">'https://www.example.com/...'</span>
|
||||
</span></code></pre></div>
|
||||
<p>If a requested language is missing, unshackle stops with an error. With <code>--best-available</code>,
|
||||
it continues with the languages it found and tells you which ones it dropped. See
|
||||
<p>If a requested language is missing, unshackle continues with the languages it found and
|
||||
tells you which ones it dropped. To stop the title instead, use <code>--require-subs</code>. See
|
||||
<a href="../downloading/#exact-vs-fuzzy-matching">exact vs fuzzy matching</a> for the full rules.</p>
|
||||
<h3 id="requiring-languages-before-downloading">Requiring languages before downloading<a class="headerlink" href="#requiring-languages-before-downloading" title="Permanent link">¶</a></h3>
|
||||
<p><code>--require-subs</code> is a gate rather than a filter. It downloads <strong>all</strong> available
|
||||
subtitles, but only if every language you name is present. If any is missing, the title
|
||||
errors out. This is useful for batch jobs where you want a title without your must-have
|
||||
language to fail loudly, and not to silently give a partial result.</p>
|
||||
<p><code>--require-subs</code> is a gate rather than a filter. If any language you name is missing, the
|
||||
title fails, even under <code>--best-available</code>. It does not select tracks: <code>--s-lang</code> still
|
||||
decides what to keep. This is useful for batch jobs where you want a title without your
|
||||
must-have language to fail loudly, and not to silently give a partial result.</p>
|
||||
<div class="language-shell highlight"><span class="filename">Fail unless both English and French subs exist, then grab everything</span><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>--require-subs<span class="w"> </span>en,fr<span class="w"> </span>EXAMPLE<span class="w"> </span>B0ABCDEFGH
|
||||
</span></code></pre></div>
|
||||
<div class="admonition warning">
|
||||
<p class="admonition-title"><code>--require-subs</code> and <code>--s-lang</code> are mutually exclusive</p>
|
||||
<p>Because <code>--require-subs</code> forces downloading of all subtitle languages, it cannot be
|
||||
combined with <code>--s-lang</code>. Choose one or the other.</p>
|
||||
</div>
|
||||
<h3 id="forced-subtitles">Forced subtitles<a class="headerlink" href="#forced-subtitles" title="Permanent link">¶</a></h3>
|
||||
<p>Forced tracks carry only the important on-screen signs and foreign-dialogue lines meant
|
||||
to display even when you watch in your own language. They are <strong>excluded by
|
||||
@@ -3282,7 +3277,7 @@ knowing when working with subtitle tracks in code:</p>
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -2758,7 +2758,7 @@
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
|
||||
|
||||
<link rel="icon" href="../../assets/favicon.svg">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.0">
|
||||
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.8.1">
|
||||
|
||||
|
||||
|
||||
@@ -2935,7 +2935,7 @@
|
||||
<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.a7633da7.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
||||
|
||||
|
||||
<script src="../../assets/javascripts/bundle.c21346df.min.js"></script>
|
||||
<script src="../../assets/javascripts/bundle.a5f9d56c.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
|
||||
Reference in New Issue
Block a user