Deployed f9c1c3d3 with MkDocs version: 1.6.1

guide/subtitles/index.html

@@ -3083,6 +3083,12 @@ relevant font packages.</p>
 <td>a list of languages</td>
 <td>Languages to sort to the top. The rest keep the default order. Nothing is removed.</td>
 </tr>
+<tr>
+<td><code>dedupe_codecs</code></td>
+<td><em>(unset)</em></td>
+<td>a list of codecs, e.g. <code>[VTT, STPP, WVTT]</code></td>
+<td>Keep one copy of a subtitle that the service sends in several codecs: the earliest listed codec wins.</td>
+</tr>
 </tbody>
 </table>
 <h3 id="which-settings-to-change">Which settings to change<a class="headerlink" href="#which-settings-to-change" title="Permanent link">&para;</a></h3>
@@ -3117,6 +3123,10 @@ only when you want something the defaults do not do:</p>
 <td><code>strip_sdh: false</code></td>
 </tr>
 <tr>
+<td>One copy of each subtitle when the service sends the same one in several codecs</td>
+<td><code>dedupe_codecs: [VTT, STPP, WVTT]</code></td>
+</tr>
+<tr>
 <td>One backend for every conversion, whatever you install</td>
 <td><code>conversion_method: &lt;backend&gt;</code></td>
 </tr>

reference/api/tracks/index.html

@@ -2947,6 +2947,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Tracks.dedupe_subtitle_codecs" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;dedupe_subtitle_codecs
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -4431,6 +4442,17 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#unshackle.core.tracks.Tracks.dedupe_subtitle_codecs" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        <code class="doc-symbol doc-symbol-toc doc-symbol-method"></code>&nbsp;dedupe_subtitle_codecs
+      
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -8416,6 +8438,27 @@ set, this method skips such a track and logs how many it skipped.</p>
 <div class="doc doc-object doc-function">
 
 
+<h3 id="unshackle.core.tracks.Tracks.dedupe_subtitle_codecs" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">dedupe_subtitle_codecs</span>
+
+
+<a href="#unshackle.core.tracks.Tracks.dedupe_subtitle_codecs" 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">dedupe_subtitle_codecs</span><span class="p">(</span><span class="n">priority</span><span class="p">)</span>
+</span></code></pre></div>
+
+    <div class="doc doc-contents ">
+
+        <p>Drop a subtitle when the same language, flag set and name exists in a codec earlier in priority.
+A subtitle in an unlisted codec is always kept.</p>
+
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
 <h3 id="unshackle.core.tracks.Tracks.sort_videos" class="doc doc-heading">
 <code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">sort_videos</span>
 

reference/configuration/download/index.html

@@ -2595,6 +2595,12 @@ in or writes them as sidecar files. See <a href="../../../guide/subtitles/">Subt
 <td><em>(unset)</em></td>
 <td>Languages to sort to the top, in the order you give. The rest keep the default order: original language first, then alphabetical. Nothing is removed.</td>
 </tr>
+<tr>
+<td><code>dedupe_codecs</code></td>
+<td>list</td>
+<td><em>(unset)</em></td>
+<td>Subtitle codecs in order of preference, by value or name, for example <code>[VTT, STPP, WVTT]</code>. When tracks of the same language, forced/SDH/CC type and name come in several listed codecs, unshackle drops the ones in a later codec. It always keeps codecs you leave out. Unset keeps every track.</td>
+</tr>
 </tbody>
 </table>
 <div class="language-yaml highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="nt">subtitle</span><span class="p">:</span>