diff --git a/README.html b/README.html index 6937fb7..e5920a2 100644 --- a/README.html +++ b/README.html @@ -78,12 +78,12 @@

Also: image transforms that had been added to RPiPlay have been ported to UxPlay:

-f {H|V|I} implements “videoflip” image transforms: H = horizontal flip (right-left flip, or mirror image); V = vertical flip ; I = 180 degree rotation or inversion (which is the combination of H with V).

-r {R|L} 90 degree Right (clockwise) or Left (counter-clockwise) rotations; these are carried out after any -f transforms.

-

-vs videosink chooses the GStreamer videosink, instead of letting autovideosink pick it for you. Some videosink choices are: ximagesink, xvimagesink, vaapisink (for intel graphics), gtksink, glimagesink, waylandsink, osximagesink (for macOS), or fpsdisplaysink (which shows the streaming framerate in fps). Using quotes “…” allows some parameters to be included with the videosink name. As an example, a user has reported success in getting fullscreen mode (which is supported by the vaapisink plugin) by using quotes in -vs "vaapisink fullscreen=true"; this also works if vaapisink is replaced by waylandsink. (The syntax of such options is specific to a given plugin; some choices of videosink might not work on your system.)

+

-vs videosink chooses the GStreamer videosink, instead of letting autovideosink pick it for you. Some videosink choices are: ximagesink, xvimagesink, vaapisink (for intel graphics), gtksink, glimagesink, waylandsink, osximagesink (for macOS), or fpsdisplaysink (which shows the streaming framerate in fps). Using quotes “…” allows some parameters to be included with the videosink name. For example, fullscreen mode is supported by the vaapisink plugin, and is obtained using -vs "vaapisink fullscreen=true"; this also works with waylandsink. The syntax of such options is specific to a given plugin, and some choices of videosink might not work on your system.

-vs 0 suppresses display of streamed video, but plays streamed audio. (The client’s screen is still mirrored at a reduced rate of 1 frame per second, but is not rendered or displayed.) This feature (which streams audio in AAC audio format) is now probably unneeded, as UxPlay can now stream superior-quality Apple Lossless audio without video in Airplay non-mirror mode.

-as audiosink chooses the GStreamer audiosink, instead of letting autoaudiosink pick it for you. Some audiosink choices are: pulsesink, alsasink, osssink, oss4sink, and osxaudiosink (for macOS). Using quotes “…” might allow some parameters to be included with the audiosink name. (Some choices of audiosink might not work on your system.)

-as 0 (or just -a) suppresses playing of streamed audio, but displays streamed video.

-nc maintains previous UxPlay < 1.45 behavior that does not close the video window when the the client sends the “Stop Mirroring” signal. This option is currently used by default in macOS, as the window created in macOS by GStreamer does not terminate correctly (it causes a segfault) if it is still open when the GStreamer pipeline is closed.

-

-t timeout will cause the server to relaunch (without stopping uxplay) if no connections have been present during the previous timeout seconds. You may wish to use this if the Server is not visible to new Clients that were inactive when the Server was launched, and an idle Bonjour registration eventually becomes unavailable for new connections (this is a workaround for what may be due to a problem with your DNS-SD or Avahi setup). This option is currently disabled in macOS, for the same reason that requires the -nc option

+

-t timeout will cause the server to relaunch (without stopping uxplay) if no connections have been present during the previous timeout seconds. You may wish to use this if the Server is not visible to new Clients that were inactive when the Server was launched, and an idle Bonjour registration eventually becomes unavailable for new connections (this is a workaround for what may be due to a problem with your DNS-SD or Avahi setup). This option is currently disabled in macOS, for the same reason that requires the -nc option.

Troubleshooting

Note: uxplay is run from a terminal command line, and informational messages are written to the terminal.

1. uxplay starts, but stalls after “Initialized server socket(s)” appears, without any server name showing on the client.

diff --git a/README.md b/README.md index b3f56af..59ac67a 100644 --- a/README.md +++ b/README.md @@ -309,10 +309,10 @@ Also: image transforms that had been added to RPiPlay have been ported to UxPlay vaapisink (for intel graphics), gtksink, glimagesink, waylandsink, osximagesink (for macOS), or fpsdisplaysink (which shows the streaming framerate in fps). Using quotes "..." allows some parameters to be included with the videosink name. - As an example, a user has reported success in - getting **fullscreen** mode (which is supported by the vaapisink plugin) by using - quotes in ``-vs "vaapisink fullscreen=true"``; this also works if ``vaapisink`` is replaced by ``waylandsink``. - (The syntax of such options is specific to a given plugin; some choices of videosink might not work on your system.) + For example, **fullscreen** mode is supported by the vaapisink plugin, and is + obtained using ``-vs "vaapisink fullscreen=true"``; this also works with ``waylandsink``. + The syntax of such options is specific to a given plugin, and some choices of videosink + might not work on your system. **-vs 0** suppresses display of streamed video, but plays streamed audio. (The client's screen is still mirrored at a reduced rate of 1 frame per second, but is not rendered or displayed.) This @@ -337,7 +337,7 @@ Also: image transforms that had been added to RPiPlay have been ported to UxPlay is not visible to new Clients that were inactive when the Server was launched, and an idle Bonjour registration eventually becomes unavailable for new connections (this is a workaround for what may be due to a problem with your DNS-SD or Avahi setup). _This option is currently disabled in - macOS, for the same reason that requires the -nc option_ + macOS, for the same reason that requires the -nc option._ # Troubleshooting diff --git a/README.txt b/README.txt index 15ea0a7..96e59a2 100644 --- a/README.txt +++ b/README.txt @@ -390,12 +390,11 @@ autovideosink pick it for you. Some videosink choices are: ximagesink, xvimagesink, vaapisink (for intel graphics), gtksink, glimagesink, waylandsink, osximagesink (for macOS), or fpsdisplaysink (which shows the streaming framerate in fps). Using quotes "..." allows some -parameters to be included with the videosink name. As an example, a user -has reported success in getting **fullscreen** mode (which is supported -by the vaapisink plugin) by using quotes in -`-vs "vaapisink fullscreen=true"`; this also works if `vaapisink` is -replaced by `waylandsink`. (The syntax of such options is specific to a -given plugin; some choices of videosink might not work on your system.) +parameters to be included with the videosink name. For example, +**fullscreen** mode is supported by the vaapisink plugin, and is +obtained using `-vs "vaapisink fullscreen=true"`; this also works with +`waylandsink`. The syntax of such options is specific to a given plugin, +and some choices of videosink might not work on your system. **-vs 0** suppresses display of streamed video, but plays streamed audio. (The client's screen is still mirrored at a reduced rate of 1 @@ -427,7 +426,7 @@ to new Clients that were inactive when the Server was launched, and an idle Bonjour registration eventually becomes unavailable for new connections (this is a workaround for what may be due to a problem with your DNS-SD or Avahi setup). *This option is currently disabled in -macOS, for the same reason that requires the -nc option* +macOS, for the same reason that requires the -nc option.* Troubleshooting ===============