Deployed 8a1fbf2 with MkDocs version: 1.6.1

dev/service-architecture/index.html

@@ -2907,9 +2907,11 @@ automatically.</p>
 needs no <code>year</code>.</p>
 <p>A <code>Song</code> also takes optional metadata keywords that the tagger and the naming templates
 read: <code>album_artist</code>, <code>release_type</code>, <code>total_tracks</code>, <code>total_discs</code>, <code>genre</code>,
-<code>explicit</code>, <code>isrc</code>, <code>upc</code>, <code>copyright</code>, <code>label</code>, <code>lyrics</code>, <code>lyrics_suffix</code>, and
-<code>artwork_url</code>. Read the class for the current list. With <code>lyrics_suffix</code> (<code>".lrc"</code>,
-<code>".ttml"</code>), unshackle also saves <code>lyrics</code> beside the final audio file under that suffix.
+<code>explicit</code>, <code>isrc</code>, <code>upc</code>, <code>copyright</code>, <code>label</code>, <code>lyrics</code>, <code>synced_lyrics</code>,
+<code>lyrics_suffix</code>, and <code>artwork_url</code>. Read the class for the current list. Give <code>lyrics</code> as
+plain text: the tagger embeds it as is. With <code>synced_lyrics</code> (timed LRC or TTML) and
+<code>lyrics_suffix</code> (<code>".lrc"</code>, <code>".ttml"</code>), unshackle also saves the timed lyrics beside the
+final audio file under that suffix.
 You can set these fields in <code>get_tracks()</code> too, and a remote client gets them back.</p>
 <p>The tagger also falls back to <code>Song.data</code> for fields the constructor did not get, such
 as the composer or a full release date. It reads the top level of that dict and a

guide/output-and-naming/index.html

@@ -3027,9 +3027,9 @@ and puts it in the file.</p>
 <p>unshackle writes lyrics when the service supplies them: a <code>LYRICS</code> Vorbis comment for FLAC, a
 <code>USLT</code> frame for MP3, and a <code>©lyr</code> atom for M4A. Ogg uses the same <code>LYRICS</code> field as
 FLAC. unshackle does not write synchronized lyrics (<code>SYLT</code>).</p>
-<p>A service can also ask for a lyrics file beside the audio, for example
-<code>08.Get.Lucky.lrc</code> next to <code>08.Get.Lucky.m4a</code>. A music player reads the timed lines from
-it. The file also comes back to the client from a remote server.</p>
+<p>The embedded lyrics are plain text. A service can also save timed lyrics in a file beside
+the audio, for example <code>08.Get.Lucky.lrc</code> next to <code>08.Get.Lucky.m4a</code>. A music player reads
+the timed lines from that file. The file also comes back to the client from a remote server.</p>
 <p>A metadata fault does not stop the run. The file is already in place, so unshackle writes a
 warning and continues.</p>
 <div class="admonition warning">

reference/api/titles/index.html

@@ -2819,8 +2819,9 @@ takes every part. A dated episode also answers to its ISO air date.
 </span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>    <span class="n">label</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 </span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>    <span class="n">lyrics</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
 </span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a>    <span class="n">artwork_url</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a>    <span class="n">lyrics_suffix</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="p">)</span>
+</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a>    <span class="n">synced_lyrics</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>    <span class="n">lyrics_suffix</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="p">)</span>
 </span></code></pre></div>
 
     <div class="doc doc-contents ">
@@ -2829,7 +2830,8 @@ takes every part. A dated episode also answers to its ISO air date.
 
 
 
-        <p><code>lyrics_suffix</code> (".lrc", ".ttml") also saves <code>lyrics</code> beside the audio file with that suffix.</p>
+        <p><code>lyrics</code> is the plain text the tagger embeds.</p>
+<p><code>synced_lyrics</code> (timed LRC or TTML) is saved beside the audio file with <code>lyrics_suffix</code> (".lrc", ".ttml").</p>