kenzuya/unshackle
1
0
Fork 2
mirror of https://github.com/unshackle-dl/unshackle.git synced 2026-11-15 13:35:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Deployed 94dfb5d6 with MkDocs version: 1.6.1

Browse Source
This commit is contained in:
2026-11-13 21:41:06 +00:00
parent 4496eab53b
commit 5cdd11e13f
3 changed files with 18 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
guide/subtitles/index.html
+16 -2
View File
@@ -2541,6 +2541,12 @@ shown in track listings. The <strong>Extension</strong> column is the file exten
<td>TMP</td>
</tr>
<tr>
<td><code>SCC</code></td>
<td>SCC</td>
<td><code>scc</code></td>
<td>Scenarist Closed Captions (CEA-608), read only</td>
</tr>
<tr>
<td><code>fTTML</code></td>
<td>STPP</td>
<td><code>stpp</code></td>
@@ -2588,6 +2594,13 @@ format-appropriate clean-up to make a single, valid file:</p>
output format, unshackle automatically converts any plain TTML track to WebVTT before
muxing (the closest lossless equivalent). Boxed <code>fTTML</code> is likewise unwrapped to TTML
first.</li>
<li><strong>SCC for muxing</strong>: Matroska cannot carry SCC, and no later step can read it. Before
muxing, unshackle converts an SCC track straight to the <code>--sub-format</code> you request
when that is SRT, WebVTT or TTML, and to SRT in all other cases (no <code>--sub-format</code>,
<code>original</code>, or another format, which unshackle then makes from the SRT). Choose
<code>--sub-format vtt</code> to keep the caption rows: WebVTT keeps a top-of-screen caption at
the top, SRT does not. unshackle reads only the CC1 channel. An SCC file with no CC1
captions gives an empty track and a warning.</li>
</ul>
<p>You normally do not need to think about any of this. It gives a clean file.</p>
<h2 id="selecting-and-filtering-subtitles">Selecting and filtering subtitles<a class="headerlink" href="#selecting-and-filtering-subtitles" title="Permanent link">&para;</a></h2>
@@ -2909,8 +2922,9 @@ styling that survives. <code>—</code> means that the backend cannot convert th
</table>
<p>Reading the table:</p>
<ul>
<li><strong>Keep the original</strong>: leaving <code>--sub-format</code> unset (or set to <code>original</code>) never
round-trips the file, so every style survives. Only convert when your player cannot
<li><strong>Keep the original</strong>: leaving <code>--sub-format</code> unset (or set to <code>original</code>) does not
round-trip the file, so every style survives. TTML and SCC are the exceptions, as noted
above. Only convert when your player cannot
read the source format.</li>
<li><strong><code>subtitleedit</code></strong> (SubtitleEdit / <code>seconv</code>): the best choice for anything → SRT. It
is the only backend that carries colour, and it embeds <code>{\an8}</code> tags to preserve