mirror of
https://github.com/unshackle-dl/unshackle.git
synced 2026-11-14 04:55:07 +00:00
Deployed 94dfb5d6 with MkDocs version: 1.6.1
This commit is contained in:
@@ -3019,7 +3019,7 @@ and <code>descriptive</code>. <code>Audio.Codec</code> covers <code>AAC</code>,
|
||||
(subtitles for the deaf and hard-of-hearing), and <code>forced</code>. A track cannot be both <code>cc</code>
|
||||
and <code>sdh</code>, and <code>forced</code> cannot combine with either. <code>Subtitle.Codec</code> includes <code>SubRip</code>
|
||||
(SRT), <code>WebVTT</code> (VTT), <code>SubStationAlpha</code>/<code>SubStationAlphav4</code> (SSA/ASS),
|
||||
<code>TimedTextMarkupLang</code> (TTML), <code>SAMI</code>, and the box-encapsulated DASH formats <code>fTTML</code>
|
||||
<code>TimedTextMarkupLang</code> (TTML), <code>SAMI</code>, <code>SCC</code>, and the box-encapsulated DASH formats <code>fTTML</code>
|
||||
(STPP) and <code>fVTT</code> (WVTT). Subtitles receive post-download normalization
|
||||
(segment merging, WebVTT sanitization, format conversion, and optional SDH stripping),
|
||||
all documented for users in <a href="../../guide/subtitles/">Subtitles</a>.</p>
|
||||
|
||||
@@ -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">¶</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
|
||||
|
||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user