mirror of
https://github.com/unshackle-dl/unshackle.git
synced 2026-11-16 05:55:09 +00:00
Deployed 511db0c7 with MkDocs version: 1.6.1
This commit is contained in:
@@ -3087,7 +3087,7 @@
|
||||
<tr>
|
||||
<td><code>--worst</code></td>
|
||||
<td>off</td>
|
||||
<td>Pick the lowest bitrate within the requested quality. <strong>Requires <code>-q</code>.</strong></td>
|
||||
<td>Pick the lowest-bitrate video at each requested resolution, or at the lowest resolution if none is set.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>--best-available</code>, <code>--warn-only</code></td>
|
||||
@@ -3544,7 +3544,7 @@ and keeps the service's numbering unchanged. Pick an order that covers the whole
|
||||
</table>
|
||||
<div class="admonition warning">
|
||||
<p class="admonition-title">Some flags cannot be combined</p>
|
||||
<p><code>--select-titles</code> and <code>--wanted</code> are mutually exclusive. <code>--worst</code> needs <code>--quality</code>. <code>--vbitrate</code> and <code>--vbitrate-range</code> (and the audio equivalents) are mutually exclusive.</p>
|
||||
<p><code>--select-titles</code> and <code>--wanted</code> are mutually exclusive. With <code>--worst</code>, hybrid mode needs <code>--quality</code>. <code>--vbitrate</code> and <code>--vbitrate-range</code> (and the audio equivalents) are mutually exclusive.</p>
|
||||
</div>
|
||||
<hr />
|
||||
<h2 id="search"><code>search</code><a class="headerlink" href="#search" title="Permanent link">¶</a></h2>
|
||||
|
||||
@@ -3258,7 +3258,8 @@ filtering. <code>--skip-dl</code> runs the license step but skips the actual seg
|
||||
<h2 id="choosing-quality">Choosing quality<a class="headerlink" href="#choosing-quality" title="Permanent link">¶</a></h2>
|
||||
<h3 id="resolution">Resolution<a class="headerlink" href="#resolution" title="Permanent link">¶</a></h3>
|
||||
<p><code>-q</code> / <code>--quality</code> takes one or more target resolutions (heights) as a comma-separated
|
||||
list. Without it, unshackle picks the <strong>best available</strong> resolution.</p>
|
||||
list. Without it, unshackle picks the <strong>best available</strong> resolution, or the lowest resolution with
|
||||
<code>--worst</code>.</p>
|
||||
<div class="language-shell highlight"><span class="filename">Single resolution</span><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>-q<span class="w"> </span><span class="m">1080</span><span class="w"> </span>EXAMPLE<span class="w"> </span><span class="m">81234567</span>
|
||||
</span></code></pre></div>
|
||||
<div class="language-shell highlight"><span class="filename">Multiple resolutions in one run</span><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>-q<span class="w"> </span><span class="m">2160</span>,1080,720<span class="w"> </span>EXAMPLE<span class="w"> </span><span class="m">81234567</span>
|
||||
@@ -3288,10 +3289,13 @@ therefore keeps its <code>3840×1920</code> HDR10 track, even when another range
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>--worst</code></td>
|
||||
<td>Within the specified quality, pick the <strong>lowest</strong> bitrate rendition. <strong>Requires <code>-q/--quality</code>.</strong></td>
|
||||
<td>Pick the lowest-bitrate video at each requested resolution. With no requested resolution, pick the lowest-bitrate video at the lowest resolution.</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>A <code>quality</code> in the config counts as a requested resolution. When <code>--best-available</code> finds none of the
|
||||
requested resolutions, <code>--worst</code> also picks from the lowest resolution. With <code>--worst</code>, hybrid mode
|
||||
requires <code>-q</code>, also when <code>--generate-dv</code> switches an HDR10 or HDR10+ request to hybrid mode.</p>
|
||||
<div class="language-shell highlight"><span class="filename">Never fail on a missing resolution</span><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>unshackle<span class="w"> </span>dl<span class="w"> </span>-q<span class="w"> </span><span class="m">2160</span><span class="w"> </span>--best-available<span class="w"> </span>EXAMPLE<span class="w"> </span>0ABC123
|
||||
</span></code></pre></div>
|
||||
<h2 id="video-codec-and-colour-range">Video codec and colour range<a class="headerlink" href="#video-codec-and-colour-range" title="Permanent link">¶</a></h2>
|
||||
@@ -3574,6 +3578,8 @@ That is the real <em>delivered</em> size, not an over-report or a bug.</p>
|
||||
declared-bitrate renditions of each quality tier, in parallel (video grouped by codec
|
||||
and range, audio by codec, channels, language, and descriptive flag). It extends a
|
||||
group downward while a lower unprobed rendition could still outrank a probed one.
|
||||
The lowest renditions are often not probed, so <code>--worst</code> usually compares their
|
||||
manifest bitrates.
|
||||
This keeps probing fast even when a service exposes dozens of renditions. A track
|
||||
whose duration unshackle cannot find falls back to <code>ffprobe</code>. A probe failure is
|
||||
non-fatal: the manifest value stays in place.</p>
|
||||
@@ -4741,7 +4747,7 @@ authoritative list.</p>
|
||||
<tr>
|
||||
<td><code>--worst</code></td>
|
||||
<td></td>
|
||||
<td>Lowest bitrate within <code>-q</code>.</td>
|
||||
<td>Lowest-bitrate video at each requested resolution, or at the lowest resolution if none is set.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>--require-audio</code></td>
|
||||
|
||||
Reference in New Issue
Block a user