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

Update README: Raspberry Pi OS no longer needs a patch

Browse Source
This commit is contained in:
fduncanh
2022-09-10 02:16:34 -04:00
parent 1bb850c18b
commit 9d9b0dc2a9
3 changed files with 82 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
README.html
View File

@@ -31,12 +31,13 @@ pipeline).</p></li>
video acceleration using Video4Linux2 (vl42), which supports both 32-
and 64-bit systems, unlike deprecated OpenMAX (omx), which is being
dropped by RPi distributions in favor of v4l2. (For GStreamer &lt; 1.22,
a <a
a backport of changes from the GStreamer development branch is needed:
this has now been done by Raspberry Pi OS (Bullseye); for other
distributions a <a
href="https://github.com/FDH2/UxPlay/wiki/Gstreamer-Video4Linux2-plugin-patches">patch</a>
to the GStreamer Video4Linux2 plugin, available in the <a
href="https://github.com/FDH2/UxPlay/wiki">UxPlay Wiki</a>, is required,
unless your distribution has made a backport of changes from the
development branch.) See <a
href="https://github.com/FDH2/UxPlay/wiki">UxPlay Wiki</a>, is
required.) See <a
href="https://github.com/FDH2/UxPlay/wiki/UxPlay-on-Raspberry-Pi:-success-reports:">success
reports</a>.</p></li>
<li><p><strong>New</strong>: Support for running on Microsoft Windows
@@ -150,10 +151,11 @@ GPU using the GStreamer plugin for Video4Linux2 (v4l2), which replaces
unmaintained 32-bit-only OpenMax used by RPiPlay. Fixes to the v4l2
plugin that allow it to work with UxPlay on RPi are now in the GStreamer
development branch, and will appear in the upcoming GStreamer-1.22
release. A (partial) backport (as
<code>gstreamer1.0-plugins-good-1.18.4-2+~rpt1</code>) has already
appeared in RPi OS updates. Until the full update appears, or for other
distributions, you can find <a
release. A backport (package
<code>gstreamer1.0-plugins-good-1.18.4-2+deb11u1+rpt1</code>) has
already appeared in RPi OS (Bullseye); for it to work with uxplay 1.56
or later, you may need to use the <code>-bt709</code> option. For other
distributions without the backport, you can find <a
href="https://github.com/FDH2/UxPlay/wiki/Gstreamer-Video4Linux2-plugin-patches">patching
instructions for GStreamer</a> in the <a
href="https://github.com/FDH2/UxPlay/wiki">UxPlay Wiki</a> for GStreamer
@@ -304,8 +306,8 @@ video. You can also test UxPlay with software-only video decoding using
option <code>-avdec</code>.</p></li>
<li><p>The upcoming GStreamer-1.22 release will work well, but older
releases of GStreamer will not work unless patched with backports of the
improvements from GStreamer-1.22. Patches for GStreamer-1.18.4 and later
are <a
improvements from GStreamer-1.22. Raspberry Pi OS (Bullseye) now has the
needed backports. For other distributions, patches for GStreamer are <a
href="https://github.com/FDH2/UxPlay/wiki/Gstreamer-Video4Linux2-plugin-patches">available
with instructions in the UxPlay Wiki</a>.</p></li>
</ul>
@@ -314,30 +316,34 @@ with instructions in the UxPlay Wiki</a>.</p></li>
<code>&lt;videosink&gt;</code> = <code>glimagesink</code> is sometimes
useful. On a system without X11 (like R Pi OS Lite) with framebuffer
video, use <code>&lt;videosink&gt;</code> = <code>kmssink</code>. With
the Wayland video compositor (as in recent Ubuntu for R Pi) use
<code>&lt;videosink&gt;</code> = <code>waylandsink</code>. For
convenience, these options are also available combined in options
<code>-rpi</code>, <code>-rpigl</code> <code>-rpifb</code>,
<code>-rpiwl</code>, respectively provided for X11, X11 with OpenGL,
framebuffer, and Wayland systems. You may find the simple “uxplay”,
(which lets GStreamer try to find the best video solution by itself)
provides the best results.</p>
the Wayland video compositor, use <code>&lt;videosink&gt;</code> =
<code>waylandsink</code>. For convenience, these options are also
available combined in options <code>-rpi</code>, <code>-rpigl</code>
<code>-rpifb</code>, <code>-rpiwl</code>, respectively provided for X11,
X11 with OpenGL, framebuffer, and Wayland systems. You may find the
simple “uxplay”, (which lets GStreamer try to find the best video
solution by itself) provides the best results.</p>
<ul>
<li><p><strong>If you are not using the latest patches from the wiki,
you will also need to add the <code>-bt709</code> option</strong>:
previously the GStreamer v4l2 plugin could not recognise Apple’s color
format (an unusual “full-range” variant of the bt709 HDTV standard),
which -bt709 fixes.</p></li>
<li><p><strong>For UxPlay-1.56 and later, if you are not using the
latest GStreamer patches from the Wiki, you will need to use the UxPlay
option <code>-bt709</code></strong>: previously the GStreamer v4l2
plugin could not recognise Apple’s color format (an unusual “full-range”
variant of the bt709 HDTV standard), which -bt709 fixes.
GStreamer-1.20.4 will have a fix for this, which is included in the
latest patches, so beginning with UxPlay-1.56, the bt709 fix is no
longer automatically applied. <strong>After a recent update, Raspberry
Pi OS (Bullseye) now supplies an already-patched GStreamer-1.18.4 that
can run UxPlay, but needs the <code>-bt709</code> option with
UxPlay-1.56 or later.</strong></p></li>
<li><p>Tip: to start UxPlay on a remote host (such as a Raspberry Pi)
using ssh:</p></li>
</ul>
<pre><code> ssh user@remote_host
export DISPLAY=:0
nohup uxplay [options] &gt; FILE &amp;</code></pre>
<p>Sound and video will play on the remote host; “nohup” will keep uplay
running if the ssh session is closed.<br />
Terminal output is saved to FILE (which can be /dev/null to discard
it).</p>
<p>Sound and video will play on the remote host; “nohup” will keep
uxplay running if the ssh session is closed. Terminal output is saved to
FILE (which can be /dev/null to discard it).</p>
<h3 id="non-debian-based-linux-or-bsd">Non-Debian-based Linux or
*BSD</h3>
<ul>