support for YouTube app HLS video language choice. also fix #452

README.html

@@ -7,6 +7,13 @@ id="now-developed-at-the-github-site-httpsgithub.comfdh2uxplay-where-all-user-is
 developed at the GitHub site <a href="https://github.com/FDH2/UxPlay"
 class="uri">https://github.com/FDH2/UxPlay</a> (where ALL user issues
 should be posted, and latest versions can be found).</strong></h3>
+<p>– <strong>NEW on github</strong>: some YouTube app HLS videos now
+offer alternative language tracks (generated by AI dubbing). Language
+choices will be made in order of preferences set with option -lang (or
+by environment variable $LANGUAGE, which it overrides). Format is
+<code>-lang fr:es:en</code>, where French (“fr”) is the first choice, if
+available, then Spanish (“es”), etc. $LANGUAGE has the same format.
+<code>-lang</code> by itself suppresses playing of dubbed audio.</p>
 <ul>
 <li><p><strong>NEW on github</strong>: Support for <strong>service
 discovery using a Bluetooth LE “beacon”</strong> for both Linux/*BSD and
@@ -1115,6 +1122,14 @@ default: 3) allows selection of the version of GStreamer’s "playbin"
 video player to use for playing HLS video. <em>(Playbin v3 is the
 recommended player, but if some videos fail to play, you can try with
 version 2.)</em></p>
+<p><strong>-lang [list]</strong> Specify language preferences for
+YouTube app HLS videos, which may offer a choice of language (based on
+AI dubbing). If this option is not used, preferences will be taken from
+environment variable $LANGUAGE, if set. Both methods specify the
+preference order as e.g. list = <code>fr:es:en</code>, fot French (first
+choice), Spanish (second choice), and English (third choice).<br />
+If “list” is not given (or list = 0), $LANGUAGE is ignored and undubbed
+audio is played.</p>
 <p><strong>-scrsv n</strong>. (since 1.73) (So far, only implemented on
 Linux/*BSD systems using D-Bus). Inhibit the screensaver in the absence
 of keyboard input (e.g., while watching video), using the
@@ -1911,7 +1926,9 @@ what version UxPlay claims to be.</p>
 screensaver while UxPlay is running (Linux/*BSD only). Add support for
 Service Discovery using a Bluetooth LE beacon. Add -vrtp option for
 forwarding decrypted h264/5 video to an external renderer (e.g., OBS
-Studio). Check that option input strings have valid UTF-8 encoding.</p>
+Studio). Check that option input strings have valid UTF-8 encoding. New
+option <code>-lang fr:es:en</code> to specify language preferences for
+YouTube HLS videos when they offer a choice.</p>
 <p>1.72.2 2025-07-07 Fix bug (typo) in DNS_SD advertisement introduced
 with -pw option. Update llhttp to v 9.3.0</p>
 <p>1.72.1 2025-06-06 minor update: fix regression in -reg option; add