README edit

This commit is contained in:
fduncanh
2021-12-14 17:33:49 -05:00
parent e52b7328f0
commit 0950dc4de7
3 changed files with 5 additions and 3 deletions

View File

@@ -62,8 +62,8 @@
<p>To troubleshoot GStreamer execute “export GST_DEBUG=2” to set the GStreamer debug-level environment-variable in the terminal where you will run uxplay, so that you see warning and error messages; (replace “2” by “4” to see much (much) more of what is happening inside GStreamer). Run “gst-inspect-1.0” to see which GStreamer plugins are installed on your system.</p>
<p>Some extra GStreamer packages for special plugins may need to be installed (or reinstalled: a user using a Wayland display system as an alternative to X11 reported that after reinstalling Lubuntu 18.4, UxPlay would not work until gstreamer1.0-x was installed, presumably for Waylands X11-compatibility mode). Different distributions may break up GStreamer 1.x into packages in different ways; the packages listed above in the build instructions should bring in other required GStreamer packages as dependencies, but will not install all possible plugins.</p>
<h3 id="failure-to-decrypt-all-video-and-audio-streams-from-a-particular-older-client">5. Failure to decrypt ALL video and audio streams from a particular (older) client:</h3>
<p>This triggers an error message, and will be due to use of an incorrect protocol for getting the AES decryption key from the client.<br />
Modern Apple clients use a more-encrypted protocol than older ones. Which protocol is used by UxPlay depends on the client <em>sourceVersion</em> (reported by the client and now shown in the terminal output). Since UxPlay 1.45, to support the third-party Windows AirPlay-client emulator <em>AirMyPC</em>, which uses the old protocol and reports itself as having sourceVersion 280.33, the legacy protocol is used for clients reporting sourceVersion 280.x.x or older. This cutoff is set as <code>OLD_PROTOCOL_CLIENT "280.33"</code> in <code>lib/global.h</code>; change it there if necessary.</p>
<p>This triggers an error message, and will be due to use of an incorrect protocol for getting the AES decryption key from the client.</p>
<p>Modern Apple clients use a more-encrypted protocol than older ones. Which protocol is used by UxPlay depends on the client <em>sourceVersion</em> (reported by the client and now shown in the terminal output). Since UxPlay 1.45, to support the third-party Windows AirPlay-client emulator <em>AirMyPC</em>, which uses the old protocol and reports itself as having sourceVersion 280.33, the legacy protocol is used for clients reporting sourceVersion 280.x.x or older. This cutoff is set as <code>OLD_PROTOCOL_CLIENT "280.33"</code> in <code>lib/global.h</code>; change it there if necessary.</p>
<h1 id="usage"><strong>Usage:</strong></h1>
<p>Options:</p>
<p><strong>-n server_name</strong> (Default: UxPlay); server_name@_hostname_ will be the name that appears offering AirPlay services to your iPad, iPhone etc, where <em>hostname</em> is the name of the server running uxplay. This will also now be the name shown above the mirror display (X11) window.</p>

View File

@@ -276,6 +276,7 @@ other required GStreamer packages as dependencies, but will not install all poss
### 5. Failure to decrypt ALL video and audio streams from a particular (older) client:
This triggers an error message, and will be due to use of an incorrect protocol for getting the AES decryption key from the client.
Modern Apple clients use a more-encrypted protocol than older ones.
Which protocol is used by UxPlay depends on the client _sourceVersion_ (reported by the client and now shown in the terminal output). Since UxPlay 1.45,
to support the third-party Windows AirPlay-client emulator _AirMyPC_, which uses the old protocol and reports itself as having sourceVersion 280.33,

View File

@@ -362,7 +362,8 @@ packages as dependencies, but will not install all possible plugins.
### 5. Failure to decrypt ALL video and audio streams from a particular (older) client:
This triggers an error message, and will be due to use of an incorrect
protocol for getting the AES decryption key from the client.\
protocol for getting the AES decryption key from the client.
Modern Apple clients use a more-encrypted protocol than older ones.
Which protocol is used by UxPlay depends on the client *sourceVersion*
(reported by the client and now shown in the terminal output). Since