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

edit README

Browse Source
This commit is contained in:
fduncanh
2022-01-15 01:46:42 -05:00
parent 6dbb22e8de
commit 1308a686a1
3 changed files with 35 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
README.html
View File

@@ -54,15 +54,15 @@
<p>Next install OpenSSL and libplist: these can be built from source (see above); only the static forms of the two libraries will used for the macOS build, so you can uninstall them (“sudo make uninstall”) after you have built UxPlay. It may be easier to get them using MacPorts “sudo port install openssl libplist-devel” or Homebrew “brew install openssl libplist” (but not Fink). if you don’t have MacPorts or Homebrew installed, you can just install one of them before building uxplay, and uninstall afterwards if it is not wanted.</p>
<p>Finally, build and install uxplay (without ZOOMFIX): open a terminal and change into the UxPlay source directory (“UxPlay-master” for zipfile downloads, “UxPlay” for “git clone” downloads) and build/install with “cmake . ; make ; sudo make install” (same as for Linux).</p>
<ul>
<li><p>On the macOS build, autovideosink uses OpenGL, not X11, to create the mirror display window (equivalent to “-vs glimagesink”; “-vs osxvideosink” can also be used). The window title does not show the Airplay server name, but it is visible to screen-sharing apps (e.g., Zoom).</p></li>
<li><p>On macOS, The option -t <em>timeout</em> is currently suppressed, and the option -nc is always used, whether or not it is selected. This is a workaround until a problem with GStreamer videosinks on macOS is fixed: if the GStreamer pipeline is destroyed while the mirror window is still open, a segfault occurs.</p></li>
<li><p>Also, the resolution settings “-s wxh” do not affect the (small) initial OpenGL mirror window size, but the window can be expanded using the mouse or trackpad. In contrast, a window created with “-vs osxvideosink” is initially big, but has the wrong aspect ratio (stretched image); in this case the aspect ratio changes when the window width is changed by dragging its side.</p></li>
<li><p>On macOS with this installation of GStreamer, the only videosinks available seem to be glimagesink (default choice made by autovideosink) and osxvideosink. (It seems that vaapisink is not supported on macOS). The window title does not show the Airplay server name, but the window is visible to screen-sharing apps (e.g., Zoom). The only available audiosink seems to be osxaudiosink.</p></li>
<li><p>On macOS, the option -t <em>timeout</em> is currently suppressed, and the option -nc is always used, whether or not it is selected. This is a workaround until a problem with GStreamer videosinks on macOS is fixed: if the GStreamer pipeline is destroyed while the mirror window is still open, a segfault occurs.</p></li>
<li><p>In the case of glimagesink, the resolution settings “-s wxh” do not affect the (small) initial OpenGL mirror window size, but the window can be expanded using the mouse or trackpad. In contrast, a window created with “-vs osxvideosink” is initially big, but has the wrong aspect ratio (stretched image); in this case the aspect ratio changes when the window width is changed by dragging its side.</p></li>
</ul>
<p><strong><em>Other ways (Homebrew, MacPorts) to install GStreamer on macOS (not recommended):</em></strong></p>
<p>First make sure that pkgconfig is installed (Homebrew: “brew install pkgconfig” ; MacPorts: “sudo port install pkgconfig” ).</p>
<ol type="a">
<li><p>with Homebrew: “brew install gst-plugins-base gst-plugins-good gst-plugins-bad gst-libav”. This appears to be functionally equivalent to using GStreamer.framework, but causes a large number of extra packages to be installed by Homebrew as dependencies. (However, as of November 2021, Homebrew offers a build of GStreamer for Apple Silicon, which then was not yet available on the offical GStreamer site.)</p></li>
<li><p>with MacPorts: “sudo port install gstreamer1-gst-plugins-base gstreamer1-gst-plugins-good gstreamer1-gst-plugins-bad gstreamer1-gst-libav”. The MacPorts GStreamer is built to use X11, so uxplay must be run from an XQuartz terminal, can use ZOOMFIX, and needs option “-vs ximagesink”. On an older unibody MacBook Pro, the default resolution wxh = 1920x1080 was too large for the non-retina display, but using option “-s 800x600” worked; However, the GStreamer pipeline is fragile against attempts to change the X11 window size, or to rotations that switch a connected client between portrait and landscape mode while uxplay is running. Using the MacPorts X11 GStreamer is only viable if the image size is left unchanged from the initial “-s wxh” setting (also use the iPad/iPhone setting that locks the screen orientation against switching between portrait and landscape mode as the device is rotated).</p></li>
<li><p>with MacPorts: “sudo port install gstreamer1-gst-plugins-base gstreamer1-gst-plugins-good gstreamer1-gst-plugins-bad gstreamer1-gst-libav”. <strong>The MacPorts GStreamer is built to use X11</strong>, so uxplay must be run from an XQuartz terminal, can use ZOOMFIX, and needs option “-vs ximagesink”. On an older unibody MacBook Pro, the default resolution wxh = 1920x1080 was too large for the non-retina display, but using option “-s 800x600” worked; However, the GStreamer pipeline is fragile against attempts to change the X11 window size, or to rotations that switch a connected client between portrait and landscape mode while uxplay is running. Using the MacPorts X11 GStreamer is only viable if the image size is left unchanged from the initial “-s wxh” setting (also use the iPad/iPhone setting that locks the screen orientation against switching between portrait and landscape mode as the device is rotated).</p></li>
</ol>
<h1 id="usage">Usage</h1>
<p>Options:</p>

16
README.md
View File

@@ -201,17 +201,17 @@ Finally, build and install uxplay (without ZOOMFIX): open a terminal and change
("UxPlay-master" for zipfile downloads, "UxPlay" for "git clone" downloads) and build/install with
"cmake . ; make ; sudo make install " (same as for Linux).
* On the macOS build, autovideosink uses OpenGL, not X11, to create the mirror display window (equivalent to
"-vs glimagesink"; "-vs osxvideosink" can also be used).
The window title does not show the Airplay server name, but it is visible to
screen-sharing apps (e.g., Zoom).
* On macOS with this installation of GStreamer, the only videosinks available seem to be glimagesink (default choice made by
autovideosink) and osxvideosink. (It seems that vaapisink is not supported
on macOS). The window title does not show the Airplay server name, but the window is visible to
screen-sharing apps (e.g., Zoom). The only available audiosink seems to be osxaudiosink.
* On macOS, The option -t _timeout_ is currently suppressed, and the option -nc is always used, whether or not it is selected.
* On macOS, the option -t _timeout_ is currently suppressed, and the option -nc is always used, whether or not it is selected.
This is a workaround until a problem with GStreamer videosinks on macOS is fixed:
if the GStreamer pipeline is destroyed while the mirror window is still open, a segfault occurs.
* Also, the resolution settings "-s wxh" do not affect
the (small) initial OpenGL mirror window size, but the window can be expanded using the mouse or trackpad.
* In the case of glimagesink, the resolution settings "-s wxh" do not affect
the (small) initial OpenGL mirror window size, but the window can be expanded using the mouse or trackpad.
In contrast, a window created with "-vs osxvideosink" is initially big, but has the wrong aspect ratio (stretched image);
in this case the aspect ratio changes when the window width is changed by dragging its side.
@@ -225,7 +225,7 @@ to using GStreamer.framework, but causes a large number of extra packages to be
Homebrew offers a build of GStreamer for Apple Silicon, which then was not yet available on the offical GStreamer site.)
(b) with MacPorts: "sudo port install gstreamer1-gst-plugins-base gstreamer1-gst-plugins-good gstreamer1-gst-plugins-bad gstreamer1-gst-libav".
The MacPorts GStreamer is built to use X11, so uxplay must be run from an XQuartz terminal, can use ZOOMFIX, and needs
**The MacPorts GStreamer is built to use X11**, so uxplay must be run from an XQuartz terminal, can use ZOOMFIX, and needs
option "-vs ximagesink". On an older unibody MacBook Pro, the default resolution wxh = 1920x1080 was too large for
the non-retina display, but using option "-s 800x600" worked; However, the GStreamer pipeline is fragile against attempts to change
the X11 window size, or to rotations that switch a connected client between portrait and landscape mode while uxplay is running.

45
README.txt
View File

@@ -262,24 +262,25 @@ change into the UxPlay source directory ("UxPlay-master" for zipfile
downloads, "UxPlay" for "git clone" downloads) and build/install with
"cmake . ; make ; sudo make install" (same as for Linux).
- On the macOS build, autovideosink uses OpenGL, not X11, to create
the mirror display window (equivalent to "-vs glimagesink"; "-vs
osxvideosink" can also be used). The window title does not show the
Airplay server name, but it is visible to screen-sharing apps (e.g.,
Zoom).
- On macOS with this installation of GStreamer, the only videosinks
available seem to be glimagesink (default choice made by
autovideosink) and osxvideosink. (It seems that vaapisink is not
supported on macOS). The window title does not show the Airplay
server name, but the window is visible to screen-sharing apps (e.g.,
Zoom). The only available audiosink seems to be osxaudiosink.
- On macOS, The option -t *timeout* is currently suppressed, and the
- On macOS, the option -t *timeout* is currently suppressed, and the
option -nc is always used, whether or not it is selected. This is a
workaround until a problem with GStreamer videosinks on macOS is
fixed: if the GStreamer pipeline is destroyed while the mirror
window is still open, a segfault occurs.
- Also, the resolution settings "-s wxh" do not affect the (small)
initial OpenGL mirror window size, but the window can be expanded
using the mouse or trackpad. In contrast, a window created with "-vs
osxvideosink" is initially big, but has the wrong aspect ratio
(stretched image); in this case the aspect ratio changes when the
window width is changed by dragging its side.
- In the case of glimagesink, the resolution settings "-s wxh" do not
affect the (small) initial OpenGL mirror window size, but the window
can be expanded using the mouse or trackpad. In contrast, a window
created with "-vs osxvideosink" is initially big, but has the wrong
aspect ratio (stretched image); in this case the aspect ratio
changes when the window width is changed by dragging its side.
***Other ways (Homebrew, MacPorts) to install GStreamer on macOS (not
recommended):***
@@ -297,16 +298,16 @@ pkgconfig" ; MacPorts: "sudo port install pkgconfig" ).
(b) with MacPorts: "sudo port install gstreamer1-gst-plugins-base
gstreamer1-gst-plugins-good gstreamer1-gst-plugins-bad
gstreamer1-gst-libav". The MacPorts GStreamer is built to use X11,
so uxplay must be run from an XQuartz terminal, can use ZOOMFIX, and
needs option "-vs ximagesink". On an older unibody MacBook Pro, the
default resolution wxh = 1920x1080 was too large for the non-retina
display, but using option "-s 800x600" worked; However, the
GStreamer pipeline is fragile against attempts to change the X11
window size, or to rotations that switch a connected client between
portrait and landscape mode while uxplay is running. Using the
MacPorts X11 GStreamer is only viable if the image size is left
unchanged from the initial "-s wxh" setting (also use the
gstreamer1-gst-libav". **The MacPorts GStreamer is built to use
X11**, so uxplay must be run from an XQuartz terminal, can use
ZOOMFIX, and needs option "-vs ximagesink". On an older unibody
MacBook Pro, the default resolution wxh = 1920x1080 was too large
for the non-retina display, but using option "-s 800x600" worked;
However, the GStreamer pipeline is fragile against attempts to
change the X11 window size, or to rotations that switch a connected
client between portrait and landscape mode while uxplay is running.
Using the MacPorts X11 GStreamer is only viable if the image size is
left unchanged from the initial "-s wxh" setting (also use the
iPad/iPhone setting that locks the screen orientation against
switching between portrait and landscape mode as the device is
rotated).