morgan/UxPlay
1
0
Fork 0
mirror of https://github.com/morgan9e/UxPlay synced 2026-04-15 00:34:05 +09:00
Code Issues Packages Projects Releases Wiki Activity

README edits

Browse Source
This commit is contained in:
fduncanh
2021-12-26 12:42:19 -05:00
parent 3cf3f7bd12
commit 577d20ea01
3 changed files with 25 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
README.html
View File

@@ -62,8 +62,8 @@
<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> <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>
<p><strong>-nh</strong> Do not append “<span class="citation" data-cites="_hostname_">@_hostname_</span>” at the end of the AirPlay server name.</p> <p><strong>-nh</strong> Do not append “<span class="citation" data-cites="_hostname_">@_hostname_</span>” at the end of the AirPlay server name.</p>
<p><strong>-s wxh</strong> (e.g. -s 1920x1080 , which is the default ) sets the display resolution (width and height, in pixels). (This may be a request made to the AirPlay client, and perhaps will not be the final resolution you get.) w and h are whole numbers with four digits or less. Note that the <strong>height</strong> pixel size is the controlling one used by the client for determining the streaming format; the width is dynamically adjusted to the shape of the image (portrait or landscape format, depending on how an iPad is held, for example).</p> <p><strong>-s wxh</strong> (e.g. -s 1920x1080 , which is the default ) sets the display resolution (width and height, in pixels). (This may be a request made to the AirPlay client, and perhaps will not be the final resolution you get.) w and h are whole numbers with four digits or less. Note that the <strong>height</strong> pixel size is the controlling one used by the client for determining the streaming format; the width is dynamically adjusted to the shape of the image (portrait or landscape format, depending on how an iPad is held, for example).</p>
<p><strong>-s wxh@r</strong> As above, but also informs the AirPlay client about the screen refresh rate of the display. Default is r=60 (60 Hz); r is a whole number with three digits or less. Values greater than 255 are invalid.</p> <p><strong>-s wxh@r</strong> As above, but also informs the AirPlay client about the screen refresh rate of the display. Default is r=60 (60 Hz); r must be a whole number less than 256.</p>
<p><strong>-fps n</strong> sets a maximum frame rate (in frames per second) for the AirPlay client to stream video; n must be a whole number with 3 digits or less. (The client may choose to serve video at any frame rate lower than this; default is 30 fps.) A setting below 30 fps might be useful to reduce latency if you are running more than one instance of uxplay at the same time. Values greater than 255 are ignored. This setting is only an advisory to the client device, so setting a high value will not force a high framerate. (You can test using “-vs fpsdisplaysink” to see what framerate is being received.)</p> <p><strong>-fps n</strong> sets a maximum frame rate (in frames per second) for the AirPlay client to stream video; n must be a whole number less than 256. (The client may choose to serve video at any frame rate lower than this; default is 30 fps.) A setting below 30 fps might be useful to reduce latency if you are running more than one instance of uxplay at the same time. <em>This setting is only an advisory to the client device, so setting a high value will not force a high framerate.</em> (You can test using “-vs fpsdisplaysink” to see what framerate is being received.)</p>
<p><strong>-o</strong> turns on an “overscanned” option for the display window. This reduces the image resolution by using some of the pixels requested by option -s wxh (or their default values 1920x1080) by adding an empty boundary frame of unused pixels (which would be lost in a full-screen display that overscans, and is not displayed by gstreamer). Recommendation: <strong>don’t use this option</strong> unless there is some special reason to use it.</p> <p><strong>-o</strong> turns on an “overscanned” option for the display window. This reduces the image resolution by using some of the pixels requested by option -s wxh (or their default values 1920x1080) by adding an empty boundary frame of unused pixels (which would be lost in a full-screen display that overscans, and is not displayed by gstreamer). Recommendation: <strong>don’t use this option</strong> unless there is some special reason to use it.</p>
<p><strong>-p</strong> allows you to select the network ports used by UxPlay (these need to be opened if the server is behind a firewall). By itself, -p sets “legacy” ports TCP 7100, 7000, 7001, UDP 6000, 6001, 7011. -p n (e.g. -p 35000) sets TCP and UDP ports n, n+1, n+2. -p n1,n2,n3 (comma-separated values) sets each port separately; -p n1,n2 sets ports n1,n2,n2+1. -p tcp n or -p udp n sets just the TCP or UDP ports. Ports must be in the range [1024-65535].</p> <p><strong>-p</strong> allows you to select the network ports used by UxPlay (these need to be opened if the server is behind a firewall). By itself, -p sets “legacy” ports TCP 7100, 7000, 7001, UDP 6000, 6001, 7011. -p n (e.g. -p 35000) sets TCP and UDP ports n, n+1, n+2. -p n1,n2,n3 (comma-separated values) sets each port separately; -p n1,n2 sets ports n1,n2,n2+1. -p tcp n or -p udp n sets just the TCP or UDP ports. Ports must be in the range [1024-65535].</p>
<p>If the -p option is not used, the ports are chosen dynamically (randomly), which will not work if a firewall is running.</p> <p>If the -p option is not used, the ports are chosen dynamically (randomly), which will not work if a firewall is running.</p>
@@ -75,8 +75,7 @@
<p><strong>-vs 0</strong> 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.</p> <p><strong>-vs 0</strong> 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.</p>
<p><strong>-as <em>audiosink</em></strong> 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.)</p> <p><strong>-as <em>audiosink</em></strong> 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.)</p>
<p><strong>-as 0</strong> (or just <strong>-a</strong>) suppresses playing of streamed audio, but displays streamed video.</p> <p><strong>-as 0</strong> (or just <strong>-a</strong>) suppresses playing of streamed audio, but displays streamed video.</p>
<p><strong>-t <em>timeout</em></strong> will cause the server to relaunch (without stopping uxplay) if no connections have been present during the previous <em>timeout</em> 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).<br /> <p><strong>-t <em>timeout</em></strong> will cause the server to relaunch (without stopping uxplay) if no connections have been present during the previous <em>timeout</em> 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). <em>This option should <strong>not</strong> be used on macOS, as a window created by GStreamer does not terminate correctly (it causes a segfault) if it is still open when the GStreamer pipeline is closed.</em></p>
<em>This option should <strong>not</strong> be used on macOS, as a window created by GStreamer does not terminate correctly (it causes a segfault) if it is still open when the GStreamer pipeline is closed.</em></p>
<h1 id="troubleshooting"><strong>Troubleshooting:</strong></h1> <h1 id="troubleshooting"><strong>Troubleshooting:</strong></h1>
<p>Note: <code>uxplay</code> is run from a terminal command line, and informational messages are written to the terminal.</p> <p>Note: <code>uxplay</code> is run from a terminal command line, and informational messages are written to the terminal.</p>
<h3 id="uxplay-starts-but-stalls-after-initialized-server-sockets-appears-without-any-server-name-showing-on-the-client.">1. uxplay starts, but stalls after “Initialized server socket(s)” appears, <em>without any server name showing on the client</em>.</h3> <h3 id="uxplay-starts-but-stalls-after-initialized-server-sockets-appears-without-any-server-name-showing-on-the-client.">1. uxplay starts, but stalls after “Initialized server socket(s)” appears, <em>without any server name showing on the client</em>.</h3>

19
README.md
View File

@@ -260,17 +260,16 @@ Options:
format, depending on how an iPad is held, for example). format, depending on how an iPad is held, for example).
**-s wxh@r** As above, but also informs the AirPlay client about the screen **-s wxh@r** As above, but also informs the AirPlay client about the screen
refresh rate of the display. Default is r=60 (60 Hz); r is a whole number refresh rate of the display. Default is r=60 (60 Hz); r must be a whole number
with three digits or less. Values greater than 255 are invalid. less than 256.
**-fps n** sets a maximum frame rate (in frames per second) for the AirPlay **-fps n** sets a maximum frame rate (in frames per second) for the AirPlay
client to stream video; n must be a whole number with 3 digits or less. client to stream video; n must be a whole number less than 256.
(The client may choose to serve video at any frame rate lower (The client may choose to serve video at any frame rate lower
than this; default is 30 fps.) A setting than this; default is 30 fps.) A setting below 30 fps might be useful to
below 30 fps might be useful to reduce latency if you are running more than reduce latency if you are running more than one instance of uxplay at the same time.
one instance of uxplay at the same time. Values greater than 255 are _This setting is only an advisory to
ignored. This setting is only an advisory to the client device, so setting the client device, so setting a high value will not force a high framerate._
a high value will not force a high framerate.
(You can test using "-vs fpsdisplaysink" to see what framerate is being (You can test using "-vs fpsdisplaysink" to see what framerate is being
received.) received.)
@@ -336,8 +335,8 @@ Also: image transforms that had been added to RPiPlay have been ported to UxPlay
have been present during the previous _timeout_ seconds. You may wish to use this if the Server 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 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 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). may be due to a problem with your DNS-SD or Avahi setup). _This option should **not** be used on
_This option should **not** be used on macOS, as a window created macOS, as a window created
by GStreamer does not terminate correctly (it causes a segfault) by GStreamer does not terminate correctly (it causes a segfault)
if it is still open when the GStreamer pipeline is closed._ if it is still open when the GStreamer pipeline is closed._

28
README.txt
View File

@@ -328,19 +328,17 @@ the shape of the image (portrait or landscape format, depending on how
an iPad is held, for example). an iPad is held, for example).
**-s wxh\@r** As above, but also informs the AirPlay client about the **-s wxh\@r** As above, but also informs the AirPlay client about the
screen refresh rate of the display. Default is r=60 (60 Hz); r is a screen refresh rate of the display. Default is r=60 (60 Hz); r must be a
whole number with three digits or less. Values greater than 255 are whole number less than 256.
invalid.
**-fps n** sets a maximum frame rate (in frames per second) for the **-fps n** sets a maximum frame rate (in frames per second) for the
AirPlay client to stream video; n must be a whole number with 3 digits AirPlay client to stream video; n must be a whole number less than 256.
or less. (The client may choose to serve video at any frame rate lower (The client may choose to serve video at any frame rate lower than this;
than this; default is 30 fps.) A setting below 30 fps might be useful to default is 30 fps.) A setting below 30 fps might be useful to reduce
reduce latency if you are running more than one instance of uxplay at latency if you are running more than one instance of uxplay at the same
the same time. Values greater than 255 are ignored. This setting is only time. *This setting is only an advisory to the client device, so setting
an advisory to the client device, so setting a high value will not force a high value will not force a high framerate.* (You can test using "-vs
a high framerate. (You can test using "-vs fpsdisplaysink" to see what fpsdisplaysink" to see what framerate is being received.)
framerate is being received.)
**-o** turns on an "overscanned" option for the display window. This **-o** turns on an "overscanned" option for the display window. This
reduces the image resolution by using some of the pixels requested by reduces the image resolution by using some of the pixels requested by
@@ -411,10 +409,10 @@ uxplay) if no connections have been present during the previous
to new Clients that were inactive when the Server was launched, and an to new Clients that were inactive when the Server was launched, and an
idle Bonjour registration eventually becomes unavailable for new idle Bonjour registration eventually becomes unavailable for new
connections (this is a workaround for what may be due to a problem with connections (this is a workaround for what may be due to a problem with
your DNS-SD or Avahi setup).\ your DNS-SD or Avahi setup). *This option should **not** be used on
*This option should **not** be used on macOS, as a window created by macOS, as a window created by GStreamer does not terminate correctly (it
GStreamer does not terminate correctly (it causes a segfault) if it is causes a segfault) if it is still open when the GStreamer pipeline is
still open when the GStreamer pipeline is closed.* closed.*
**Troubleshooting:** **Troubleshooting:**
==================== ====================