diff --git a/README.html b/README.html index 60f2ceb..4bb34f4 100644 --- a/README.html +++ b/README.html @@ -56,7 +56,7 @@

The “OpenGL renderer” window created on Linux by “-vs glimagesink” sometimes does not close properly when its “close” button is clicked. (this is a GStreamer issue). You may need to terminate uxplay with Ctrl-C to close a “zombie” OpenGl window.

GStreamer issues: 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.

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 Wayland’s 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.

-

Use with non-Apple clients: third-party Windows-bases AirPlay clients such as AirMyPC typically use an older protocol that omits the hashing of the audio AES key with the “shared secret” ecdh_secret created during the initial pairing-handshake between client and server. Omission of this step was necessary for successful decryption of audio and video streams from the AirMyPC client, which emulates an old version of iOS, and reports its sourceVersion as 280.33. The line #define OLD_PROTOCOL_CLIENT "280.33" in lib/global.h makes UxPlay skip the aeskey hashing step when the client reports this or an older value as its sourceVersion. If both audio and video decryption fail when using another third-party client, and uxplay -d output shows that it reports a later sourceVersion, try increasing the value in global.h.

+

Use with non-Apple clients: third-party Windows-based AirPlay clients such as AirMyPC typically use an older protocol that omits the hashing of the audio AES key with the “shared secret” ecdh_secret created during the initial pairing-handshake between client and server. Omission of this step is necessary for successful decryption of audio and video streams from the AirMyPC client, which emulates an old version of iOS, and reports its sourceVersion as 280.33. The line #define OLD_PROTOCOL_CLIENT "280.33" in lib/global.h makes UxPlay skip the aeskey hashing step when the client reports this or an older value as its sourceVersion. If both audio and video decryption fail when using another third-party client, and uxplay -d output shows that it reports a later sourceVersion, try increasing the value in global.h.

Usage:

Options:

-n server_name (Default: UxPlay); server_name@_hostname_ will be the name that appears offering AirPlay services to your iPad, iPhone etc, where hostname is the name of the server running uxplay. This will also now be the name shown above the mirror display (X11) window.

diff --git a/README.md b/README.md index 0e1119b..e4efaa0 100644 --- a/README.md +++ b/README.md @@ -251,9 +251,9 @@ reported that after reinstalling Lubuntu 18.4, UxPlay would not work until gstr 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. -**Use with non-Apple clients**: third-party Windows-bases AirPlay clients such as AirMyPC typically use an older protocol +**Use with non-Apple clients**: third-party Windows-based AirPlay clients such as AirMyPC typically use an older protocol that omits the hashing of the audio AES key with the "shared secret" ```ecdh_secret``` created during the initial -pairing-handshake between client and server. Omission of this step was necessary for successful decryption of audio and video +pairing-handshake between client and server. Omission of this step is necessary for successful decryption of audio and video streams from the AirMyPC client, which emulates an old version of iOS, and reports its ```sourceVersion``` as ```280.33```. The line ```#define OLD_PROTOCOL_CLIENT "280.33"``` in ```lib/global.h``` makes UxPlay skip the aeskey hashing step when the client reports this or an older value as its sourceVersion. If both audio and video decryption fail when using another third-party client, and diff --git a/README.txt b/README.txt index 8063aa6..014de28 100644 --- a/README.txt +++ b/README.txt @@ -333,11 +333,11 @@ 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. -**Use with non-Apple clients**: third-party Windows-bases AirPlay +**Use with non-Apple clients**: third-party Windows-based AirPlay clients such as AirMyPC typically use an older protocol that omits the hashing of the audio AES key with the "shared secret" `ecdh_secret` created during the initial pairing-handshake between client and server. -Omission of this step was necessary for successful decryption of audio +Omission of this step is necessary for successful decryption of audio and video streams from the AirMyPC client, which emulates an old version of iOS, and reports its `sourceVersion` as `280.33`. The line `#define OLD_PROTOCOL_CLIENT "280.33"` in `lib/global.h` makes UxPlay