Deployed 2dd2046 with MkDocs version: 1.6.1

2026-11-14 04:55:07 +00:00 · 2026-10-18 18:24:35 +00:00
parent 73659f9d4c
commit 4bce924566
7 changed files with 121 additions and 6 deletions
@@ -3693,7 +3693,7 @@ ignore it safely. See <a href="../../creating-a-service/#split-episodes">Split e
 </span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w">      </span><span class="nt">"bitrate"</span><span class="p">:</span><span class="w"> </span><span class="mi">8000</span><span class="p">,</span><span class="w"> </span><span class="nt">"bitrate_bps"</span><span class="p">:</span><span class="w"> </span><span class="mi">8000000</span><span class="p">,</span><span class="w"> </span><span class="nt">"width"</span><span class="p">:</span><span class="w"> </span><span class="mi">3840</span><span class="p">,</span><span class="w"> </span><span class="nt">"height"</span><span class="p">:</span><span class="w"> </span><span class="mi">2160</span><span class="p">,</span>
 </span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="w">      </span><span class="nt">"resolution"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2160p"</span><span class="p">,</span><span class="w"> </span><span class="nt">"fps"</span><span class="p">:</span><span class="w"> </span><span class="s2">"24"</span><span class="p">,</span><span class="w"> </span><span class="nt">"range"</span><span class="p">:</span><span class="w"> </span><span class="s2">"HDR10"</span><span class="p">,</span>
 </span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w">      </span><span class="nt">"range_display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"HDR10"</span><span class="p">,</span><span class="w"> </span><span class="nt">"scan_type"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w"> </span><span class="nt">"closed_captions"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span>
-</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">      </span><span class="nt">"dv_compatible_bitstream"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w"> </span><span class="nt">"language"</span><span class="p">:</span><span class="w"> </span><span class="s2">"en"</span><span class="p">,</span><span class="w"> </span><span class="nt">"is_original_lang"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
+</span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w">      </span><span class="nt">"dv_compatible_bitstream"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w"> </span><span class="nt">"hdr10plus"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w"> </span><span class="nt">"language"</span><span class="p">:</span><span class="w"> </span><span class="s2">"en"</span><span class="p">,</span><span class="w"> </span><span class="nt">"is_original_lang"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
 </span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="w">      </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w"> </span><span class="nt">"needs_repack"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w"> </span><span class="nt">"edition"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w"> </span><span class="nt">"data"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
 </span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w">      </span><span class="nt">"drm"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span><span class="w"> </span><span class="nt">"descriptor"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DASH"</span>
 </span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w">    </span><span class="p">}</span>
@@ -3309,6 +3309,10 @@ HEVC; a title whose HDR10/HDR10+ tracks are all in another codec fails before it
 If the hybrid step fails for one resolution, unshackle logs an error, skips that resolution
 and goes on with the other resolutions of the title. When no hybrid file at all was made,
 the title fails.</p>
+<p>A DV track that carries HDR10+ (<code>DV+HDR10P</code> in <code>--list</code>) is already a hybrid. At a resolution
+that has one, <code>-r HYBRID</code> selects the DV+HDR10P track with the highest bitrate (the lowest with
+<code>--worst</code>) and muxes it as it is, with no base track and no dovi_tool step. The other
+resolutions get a hybrid that unshackle makes.</p>
 <p>To keep an HDR10+ deliverable <em>alongside</em> the hybrid, request both ranges:
 <code>-r HYBRID,HDR10P</code>. <code>-r HYBRID</code> on its own muxes only the merged hybrid.</p>
 </div>
@@ -2859,6 +2859,17 @@
    </span>
  </a>
  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Tracks.select_hybrid" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;select_hybrid
+      
+    </span>
+  </a>
+  
 </li>
        
          <li class="md-nav__item">
@@ -2900,6 +2911,17 @@
    <nav class="md-nav" aria-label=" Video">
      <ul class="md-nav__list">
        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Video.range_label" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-attribute"></code>&nbsp;range_label
+      
+    </span>
+  </a>
+  
+</li>
+        
          <li class="md-nav__item">
  <a href="#unshackle.core.tracks.Video.Range" class="md-nav__link">
    <span class="md-ellipsis">
@@ -4090,6 +4112,17 @@
    </span>
  </a>
  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Tracks.select_hybrid" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;select_hybrid
+      
+    </span>
+  </a>
+  
 </li>
        
          <li class="md-nav__item">
@@ -4131,6 +4164,17 @@
    <nav class="md-nav" aria-label=" Video">
      <ul class="md-nav__list">
        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Video.range_label" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-attribute"></code>&nbsp;range_label
+      
+    </span>
+  </a>
+  
+</li>
+        
          <li class="md-nav__item">
  <a href="#unshackle.core.tracks.Video.Range" class="md-nav__link">
    <span class="md-ellipsis">
@@ -7753,7 +7797,29 @@ HDR10+.</p>

        <p>Mark tracks selected only as hybrid ingredients so the standalone mux loop skips them.</p>
 <p>A track that the caller also selected as an explicit deliverable (same track in both
-selections) stays unflagged, and the standalone mux loop muxes it alongside the hybrid.</p>
+selections) stays unflagged, and the standalone mux loop muxes it alongside the hybrid.
+A <code>native_hybrid</code> track is the hybrid itself, so it stays unflagged too.</p>
+
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="unshackle.core.tracks.Tracks.select_hybrid" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">select_hybrid</span>
+
+
+<a href="#unshackle.core.tracks.Tracks.select_hybrid" class="headerlink" title="Permanent link">&para;</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">select_hybrid</span><span class="p">(</span><span class="n">tracks</span><span class="p">,</span> <span class="n">quality</span><span class="p">,</span> <span class="n">worst</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+</span></code></pre></div>
+
+    <div class="doc doc-contents ">
+
+        <p>A filter for the hybrid ingredients of each resolution. It sets <code>native_hybrid</code> on every track.</p>
+<p>A DV track that carries HDR10+ is already a hybrid, so its resolution takes that track and no base.</p>


    </div>
@@ -7976,8 +8042,9 @@ share a video list must pass distinct paths to avoid clobbering each other.</p>
 </span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>    <span class="n">scan_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 </span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>    <span class="n">closed_captions</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 </span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>    <span class="n">dv_compatible_bitstream</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
-</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="p">)</span>
+</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>    <span class="n">hdr10plus</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
+</span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="p">)</span>
 </span></code></pre></div>

    <div class="doc doc-contents ">
@@ -8102,6 +8169,22 @@ All strings will be cast to either a number or float.</p>
                  <code>None</code>
            </td>
          </tr>
+          <tr class="doc-section-item">
+            <td>
+                <code>hdr10plus</code>
+            </td>
+            <td>
+                  <code><span title="bool">bool</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The DV track also carries HDR10+ metadata. The HDR10+ probe sets it.</p>
+              </div>
+            </td>
+            <td>
+                  <code>False</code>
+            </td>
+          </tr>
      </tbody>
    </table>
        <p>Note: If codec, bitrate, width, height, or fps is not specified, unshackle can
@@ -8125,6 +8208,30 @@ skip some checks or assume a value. Give as much information as possible.</p>



+<div class="doc doc-object doc-attribute">
+
+
+
+<h3 id="unshackle.core.tracks.Video.range_label" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>            <span class="doc doc-object-name doc-attribute-name">range_label</span>
+
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-property"><code>property</code></small>
+  </span>
+
+<a href="#unshackle.core.tracks.Video.range_label" class="headerlink" title="Permanent link">&para;</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="n">range_label</span>
+</span></code></pre></div>
+
+    <div class="doc doc-contents ">
+
+        <p>The range name, with <code>+HDR10P</code> on a DV track that also carries HDR10+.</p>
+
+    </div>
+
+</div>
+


 <div class="doc doc-object doc-class">
@@ -2880,6 +2880,10 @@ language in both modes, so they never trigger <code>{dual}</code> on their own.<
 reads the first fragment of HEVC HDR10 tracks from DASH, HLS fMP4 and one-file sources. A track
 whose first frame carries HDR10+ (SMPTE ST 2094-40) metadata becomes <code>HDR10P</code>. Then <code>-r HDR10P</code>,
 <code>--list</code> and <a href="../../../guide/downloading/#dolby-vision-from-hdr10"><code>--generate-dv</code></a> use it.</p>
+<p>unshackle also probes HEVC Dolby Vision tracks. A DV track that carries HDR10+ keeps its <code>DV</code>
+range, so <code>-r DV</code> selects it, and <code>--list</code> shows it as <code>DV+HDR10P</code>. <code>-r HYBRID</code> uses it as the
+<a href="../../../guide/downloading/#colour-range">hybrid</a> of its resolution, with no base track. The
+HDR10 tracks and the DV tracks of a title are sampled as two separate sets.</p>
 <p>When two HDR10 tracks have the same resolution, they can be an HDR10 encode and an HDR10+ encode
 side by side, so unshackle probes every track. When each track has its own resolution, unshackle
 probes the two highest and the two lowest bitrates first:</p>
@@ -2373,7 +2373,7 @@ the remote client's <code>-q</code> when the remote session starts:</p>
  The service sees the DRM system and security level of the client's device. A client with no
  local CDM gets a <code>SERVER_CDM_CAPPED</code> error.</li>
 <li>A download job must pass a <code>quality</code> at or below the limit, and must not set <code>best_available</code> or
-  a <code>HYBRID</code> range. <code>HYBRID</code> always keeps the lowest Dolby Vision track, at any quality. A job with
+  a <code>HYBRID</code> range. <code>HYBRID</code> can keep the lowest Dolby Vision track, at any quality. A job with
  no <code>quality</code>, with a higher one, with <code>best_available</code>, or with <code>HYBRID</code> gets a <code>SERVER_CDM_CAPPED</code>
  error. The server checks the values the job runs with, after it applies the service defaults
  and the <code>serve:</code> download defaults.</li>