Deployed 35871f3 with MkDocs version: 1.6.1

dev/creating-a-service/index.html

@@ -2566,8 +2566,16 @@ fetching tracks:</p>
 </span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>    <span class="n">codecs</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Video</span><span class="o">.</span><span class="n">Codec</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span>            <span class="c1"># empty == accept any codec</span>
 </span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>    <span class="n">ranges</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Video</span><span class="o">.</span><span class="n">Range</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">Video</span><span class="o">.</span><span class="n">Range</span><span class="o">.</span><span class="n">SDR</span><span class="p">]</span>
 </span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>    <span class="n">best_available</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>    <span class="n">generate_dv</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span>                 <span class="c1"># --generate-dv: make Dolby Vision from HDR10+</span>
 </span></code></pre></div>
 <div class="admonition note">
+<p class="admonition-title"><code>generate_dv</code> and a hand-made HYBRID</p>
+<p>A service that fetches the HYBRID variants itself (HDR10 and DV) must also fetch
+HDR10P when <code>track_request.generate_dv</code> is set and the title has no DV track.
+The conversion needs an HEVC HDR10+ track as its base.
+<code>get_tracks_for_variants</code> does this for you.</p>
+</div>
+<div class="admonition note">
 <p class="admonition-title">Read the request, don't second-guess the user</p>
 <p>Services may narrow <code>track_request</code> for hard technical constraints (e.g.
 <em>"this service delivers HDR only as HEVC"</em>), but must <strong>not</strong> filter

dev/rest-api/endpoints/index.html

@@ -4066,6 +4066,12 @@ ignore it safely. See <a href="../../creating-a-service/#split-episodes">Split e
 <td>Fall back to best available. With <code>all_drm</code>, a DRM system that does not license is a warning.</td>
 </tr>
 <tr>
+<td><code>generate_dv</code></td>
+<td>boolean</td>
+<td><code>false</code></td>
+<td>With <code>HYBRID</code> in <code>range</code>, make Dolby Vision from the HDR10+ metadata when a title has no DV track. Needs <code>hdr10plus_tool</code> on the server. Without <code>HYBRID</code> in <code>range</code>, the request returns <code>400</code>.</td>
+</tr>
+<tr>
 <td><code>repack</code></td>
 <td>boolean</td>
 <td><code>false</code></td>

dev/rest-api/remote-sessions/index.html

@@ -2536,8 +2536,8 @@ server does not have to prompt:</p>
   The client also downloads playlists and segments through the same proxy,
   as a local run does. <code>--no-proxy-download</code> and <code>--proxy-download</code> change
   that for downloads only.</li>
-<li>Track-selection hints (<code>range_</code>, <code>vcodec</code>, <code>quality</code>, <code>best_available</code>) so
-  the server fetches the right manifests</li>
+<li>Track-selection hints (<code>range_</code>, <code>vcodec</code>, <code>quality</code>, <code>best_available</code>,
+  <code>generate_dv</code>) so the server fetches the right manifests</li>
 <li>Your language and audio codec selection (<code>-l</code>, <code>-vl</code>, <code>-al</code>, <code>-a</code>, <code>-fs</code>)
   in a <code>dl_params</code> object. Some services fetch one manifest
   for each audio language, and pick the languages from these values</li>
@@ -2901,7 +2901,7 @@ from a browser origin, not when you want only the local HTTP API.</p>
 answers CDM calls), <code>cdm_system_id</code> and <code>cdm_device_type</code> (Widevine only), <code>service_config</code>
 (the identity config keys the service lists in <code>client_config</code>), <code>client</code> (a freeform identity
 object the dashboard shows as sent), and the track-selection hints <code>range_</code>, <code>vcodec</code>,
-<code>quality</code>, <code>best_available</code>, plus arbitrary service CLI options
+<code>quality</code>, <code>best_available</code>, <code>generate_dv</code>, plus arbitrary service CLI options
 (<code>additionalProperties: true</code>).</p>
 <p><code>dl_params</code> holds the <code>dl</code> track selection: <code>lang</code>, <code>v_lang</code> and <code>a_lang</code>
 (arrays of language strings), <code>acodec</code> (an array of audio codec names, such as

dev/service-architecture/index.html

@@ -2835,8 +2835,10 @@ See <a href="../../guide/proxies-and-vpn/">Proxies and VPN</a>.</p>
 <p class="admonition-title"><code>TrackRequest</code></p>
 <p><code>self.track_request</code> is a small dataclass built from the CLI: <code>codecs</code>
 (from <code>--vcodec</code>, empty means "accept any"), <code>ranges</code> (from <code>--range</code>, default
-<code>[Video.Range.SDR]</code>), and <code>best_available</code>. Use it in <code>get_tracks</code> to decide which
-variants to fetch.</p>
+<code>[Video.Range.SDR]</code>), <code>best_available</code>, and <code>generate_dv</code> (from <code>--generate-dv</code>).
+Use it in <code>get_tracks</code> to decide which variants to fetch. A service that fetches
+the HYBRID variants itself must also fetch HDR10P when <code>generate_dv</code> is set and
+the title has no DV track, because the conversion needs an HEVC HDR10+ base.</p>
 </div>
 <h2 id="titles-and-the-title-hierarchy">Titles and the <code>Title</code> hierarchy<a class="headerlink" href="#titles-and-the-title-hierarchy" title="Permanent link">&para;</a></h2>
 <p><code>get_titles()</code> returns a <strong>title collection</strong>, one of the <code>Titles_T</code> types. Each