mirror of
https://github.com/morgan9e/UxPlay
synced 2026-04-14 00:04:13 +09:00
edit README
This commit is contained in:
fduncanh
10
README.html
10
README.html
@@ -20,11 +20,13 @@
|
||||
</ul>
|
||||
<h3 id="possibility-for-using-hardware-accelerated-h264-video-decoding-if-available.">Possibility for using hardware-accelerated h264 video-decoding, if available.</h3>
|
||||
<p>UxPlay uses <a href="https://gstreamer.freedesktop.org">GStreamer</a> Plugins for rendering audio and video, This means that video and audio are supported “out of the box”, using a choice of plugins. AirPlay streams video in h264 format: gstreamer decoding is plugin agnostic, and uses accelerated GPU hardware h264 decoders if available; if not, software decoding is used.</p>
|
||||
<p>For systems with Intel or AMD integrated graphics, hardware GPU decoding with the gstreamer VAAPI plugin is preferable. VAAPI is open-source, and in addition to Intel and AMD graphics, the open-source “Nouveau” drivers for NVIDIA graphics are also in principle supported: see <a href="https://nouveau.freedesktop.org/VideoAcceleration.html">here</a>, which requires VAAPI to be supplemented with firmware extracted from the proprietary NVIDIA drivers.</p>
|
||||
<p>For NVIDIA graphics with the proprietary drivers, the <code>nvh264dec</code> plugin (included in gstreamer1.0-plugins-bad since GStreamer-1.18.0) can be used for accelerated video decoding on the NVIDIA GPU after NVIDIA’s CUDA driver <code>libcuda.so</code> is installed. This plugin should be used with options <code>uxplay -vd nvh264dec -vs glimagesink</code>. For GStreamer-1.16.3 or earlier, replace <code>nvh264dec</code> by the older plugin<code>nvdec</code>, which must be built by the user: see <a href="https://github.com/FDH2/UxPlay/wiki/NVIDIA-nvdec-and-nvenc-plugins">these instructions</a>.</p>
|
||||
<ul>
|
||||
<li><p><strong>GPU Support for Raspberry Pi</strong></p>
|
||||
<p>Raspberry Pi (RPi) computers can run UxPlay with software decoding of h264 video (by adding <code>-avdec</code> to the uxplay options) but this usually has unacceptable latency, and hardware-accelerated decoding by the Pi’s built-in Broadcom GPU should be used. RPi OS (Bullseye) has stopped supporting the unmaintained 32-bit-only omx (OpenMAX) driver used for this by <a href="http://github.com/FD-/RPiPlay">RPiPlay</a>, in favor of v4l2 (Video4Linux2). Fixes to the GStreamer v4l2 plugin that allow it to work with UxPlay on RPi are now in the GStreamer development branch, and will be available 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 if you are using a different distribution, 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>. Patches are available for all GStreamer releases 1.18.4 and later.</p></li>
|
||||
<li><p><strong>VAAPI for Intel and AMD integrated graphics, NVIDIA with “Nouveau” open-source driver</strong></p>
|
||||
<p>With an Intel or AMD GPU, hardware decoding with the gstreamer open-source VAAPI gstreamer plugin is preferable. The open-source “Nouveau” drivers for NVIDIA graphics are also in principle supported: see <a href="https://nouveau.freedesktop.org/VideoAcceleration.html">here</a>, but this requires VAAPI to be supplemented with firmware extracted from the proprietary NVIDIA drivers.</p></li>
|
||||
<li><p><strong>NVIDIA with proprietary drivers</strong></p>
|
||||
<p>The <code>nvh264dec</code> plugin (included in gstreamer1.0-plugins-bad since GStreamer-1.18.0) can be used for accelerated video decoding on the NVIDIA GPU after NVIDIA’s CUDA driver <code>libcuda.so</code> is installed. This plugin should be used with options <code>uxplay -vd nvh264dec -vs glimagesink</code>. For GStreamer-1.16.3 or earlier, replace <code>nvh264dec</code> by the older plugin<code>nvdec</code>, which must be built by the user: See <a href="https://github.com/FDH2/UxPlay/wiki/NVIDIA-nvdec-and-nvenc-plugins">these instructions</a>.</p></li>
|
||||
<li><p><strong>Support for the Raspberry Pi Broadcom GPU</strong></p>
|
||||
<p>Raspberry Pi (RPi) computers can run UxPlay with software decoding of h264 video (by adding <code>-avdec</code> to the uxplay options) but this usually has unacceptable latency, and hardware-accelerated GPU decoding should be used. The unmaintained 32-bit-only omx (OpenMAX) driver used for this by <a href="http://github.com/FD-/RPiPlay">RPiPlay</a> is no longer officially supported by RPi OS (Bullseye): the replacement is v4l2 (Video4Linux2). Fixes to the GStreamer v4l2 plugin that allow it to work with UxPlay on RPi are now in the GStreamer development branch, and will be available 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 if you are using a different distribution, 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>. Patches are available for all GStreamer releases 1.18.4 and later.</p></li>
|
||||
</ul>
|
||||
<h3 id="note-to-packagers-openssl-3.0.0-solves-gpl-v3-license-issues.">Note to packagers: OpenSSL-3.0.0 solves GPL v3 license issues.</h3>
|
||||
<p>Some Linux distributions such as Debian do not allow distribution of compiled GPL code linked to OpenSSL-1.1.1 because its “dual OpenSSL/SSLeay” license has some incompatibilities with GPL, unless all code authors have explicitly given an “exception” to allow such linking (the historical origins of UxPlay make this impossible to obtain). Other distributions treat OpenSSL as a “System Library” which the GPL allows linking to.</p>
|
||||
|
||||
40
README.md
40
README.md
@@ -86,29 +86,33 @@ This means that video and audio are supported "out of the box", using a choice o
|
||||
AirPlay streams video in h264 format: gstreamer decoding is plugin agnostic, and uses accelerated GPU hardware
|
||||
h264 decoders if available; if not, software decoding is used.
|
||||
|
||||
For systems with Intel or AMD integrated graphics, hardware GPU decoding with the gstreamer VAAPI plugin is preferable. VAAPI is
|
||||
open-source, and in addition to Intel and AMD graphics, the open-source "Nouveau" drivers for NVIDIA
|
||||
graphics are also in principle supported: see [here](https://nouveau.freedesktop.org/VideoAcceleration.html),
|
||||
which requires VAAPI to be supplemented with firmware extracted from the proprietary NVIDIA drivers.
|
||||
* **VAAPI for Intel and AMD integrated graphics, NVIDIA with "Nouveau" open-source driver**
|
||||
|
||||
For NVIDIA graphics with the proprietary drivers, the `nvh264dec` plugin
|
||||
(included in gstreamer1.0-plugins-bad since GStreamer-1.18.0)
|
||||
can be used for accelerated video decoding on the NVIDIA GPU after
|
||||
NVIDIA's CUDA driver `libcuda.so` is installed.
|
||||
This plugin should be used with options
|
||||
`uxplay -vd nvh264dec -vs glimagesink`. For GStreamer-1.16.3
|
||||
or earlier, replace `nvh264dec` by the older plugin`nvdec`, which
|
||||
must be built by the user:
|
||||
see [these instructions](https://github.com/FDH2/UxPlay/wiki/NVIDIA-nvdec-and-nvenc-plugins).
|
||||
With an Intel or AMD GPU, hardware decoding with the gstreamer open-source VAAPI gstreamer plugin is preferable.
|
||||
The open-source "Nouveau" drivers for NVIDIA
|
||||
graphics are also in principle supported: see [here](https://nouveau.freedesktop.org/VideoAcceleration.html),
|
||||
but this requires VAAPI to be supplemented with firmware extracted from the proprietary NVIDIA drivers.
|
||||
|
||||
* **GPU Support for Raspberry Pi**
|
||||
* **NVIDIA with proprietary drivers**
|
||||
|
||||
The `nvh264dec` plugin
|
||||
(included in gstreamer1.0-plugins-bad since GStreamer-1.18.0)
|
||||
can be used for accelerated video decoding on the NVIDIA GPU after
|
||||
NVIDIA's CUDA driver `libcuda.so` is installed.
|
||||
This plugin should be used with options
|
||||
`uxplay -vd nvh264dec -vs glimagesink`. For GStreamer-1.16.3
|
||||
or earlier, replace `nvh264dec` by the older plugin`nvdec`, which
|
||||
must be built by the user:
|
||||
See [these instructions](https://github.com/FDH2/UxPlay/wiki/NVIDIA-nvdec-and-nvenc-plugins).
|
||||
|
||||
* **Support for the Raspberry Pi Broadcom GPU**
|
||||
|
||||
Raspberry Pi (RPi) computers can run UxPlay with software decoding
|
||||
of h264 video (by adding `-avdec` to the uxplay options) but this
|
||||
usually has unacceptable latency, and hardware-accelerated decoding by
|
||||
the Pi's built-in Broadcom GPU should be used. RPi OS (Bullseye) has
|
||||
stopped supporting the unmaintained 32-bit-only omx (OpenMAX) driver
|
||||
used for this by [RPiPlay](http://github.com/FD-/RPiPlay), in favor of v4l2
|
||||
usually has unacceptable latency, and hardware-accelerated GPU decoding
|
||||
should be used. The unmaintained 32-bit-only omx (OpenMAX) driver
|
||||
used for this by [RPiPlay](http://github.com/FD-/RPiPlay) is no longer
|
||||
officially supported by RPi OS (Bullseye): the replacement is v4l2
|
||||
(Video4Linux2). Fixes to the GStreamer v4l2 plugin that allow it to
|
||||
work with UxPlay on RPi are now in the GStreamer development
|
||||
branch, and will be available in the upcoming GStreamer-1.22 release,
|
||||
|
||||
49
README.txt
49
README.txt
@@ -94,33 +94,38 @@ h264 format: gstreamer decoding is plugin agnostic, and uses accelerated
|
||||
GPU hardware h264 decoders if available; if not, software decoding is
|
||||
used.
|
||||
|
||||
For systems with Intel or AMD integrated graphics, hardware GPU decoding
|
||||
with the gstreamer VAAPI plugin is preferable. VAAPI is open-source, and
|
||||
in addition to Intel and AMD graphics, the open-source "Nouveau" drivers
|
||||
for NVIDIA graphics are also in principle supported: see
|
||||
[here](https://nouveau.freedesktop.org/VideoAcceleration.html), which
|
||||
requires VAAPI to be supplemented with firmware extracted from the
|
||||
proprietary NVIDIA drivers.
|
||||
- **VAAPI for Intel and AMD integrated graphics, NVIDIA with "Nouveau"
|
||||
open-source driver**
|
||||
|
||||
For NVIDIA graphics with the proprietary drivers, the `nvh264dec` plugin
|
||||
(included in gstreamer1.0-plugins-bad since GStreamer-1.18.0) can be
|
||||
used for accelerated video decoding on the NVIDIA GPU after NVIDIA's
|
||||
CUDA driver `libcuda.so` is installed. This plugin should be used with
|
||||
options `uxplay -vd nvh264dec -vs glimagesink`. For GStreamer-1.16.3 or
|
||||
earlier, replace `nvh264dec` by the older plugin`nvdec`, which must be
|
||||
built by the user: see [these
|
||||
instructions](https://github.com/FDH2/UxPlay/wiki/NVIDIA-nvdec-and-nvenc-plugins).
|
||||
With an Intel or AMD GPU, hardware decoding with the gstreamer
|
||||
open-source VAAPI gstreamer plugin is preferable. The open-source
|
||||
"Nouveau" drivers for NVIDIA graphics are also in principle
|
||||
supported: see
|
||||
[here](https://nouveau.freedesktop.org/VideoAcceleration.html), but
|
||||
this requires VAAPI to be supplemented with firmware extracted from
|
||||
the proprietary NVIDIA drivers.
|
||||
|
||||
- **GPU Support for Raspberry Pi**
|
||||
- **NVIDIA with proprietary drivers**
|
||||
|
||||
The `nvh264dec` plugin (included in gstreamer1.0-plugins-bad since
|
||||
GStreamer-1.18.0) can be used for accelerated video decoding on the
|
||||
NVIDIA GPU after NVIDIA's CUDA driver `libcuda.so` is installed.
|
||||
This plugin should be used with options
|
||||
`uxplay -vd nvh264dec -vs glimagesink`. For GStreamer-1.16.3 or
|
||||
earlier, replace `nvh264dec` by the older plugin`nvdec`, which must
|
||||
be built by the user: See [these
|
||||
instructions](https://github.com/FDH2/UxPlay/wiki/NVIDIA-nvdec-and-nvenc-plugins).
|
||||
|
||||
- **Support for the Raspberry Pi Broadcom GPU**
|
||||
|
||||
Raspberry Pi (RPi) computers can run UxPlay with software decoding
|
||||
of h264 video (by adding `-avdec` to the uxplay options) but this
|
||||
usually has unacceptable latency, and hardware-accelerated decoding
|
||||
by the Pi's built-in Broadcom GPU should be used. RPi OS (Bullseye)
|
||||
has stopped supporting the unmaintained 32-bit-only omx (OpenMAX)
|
||||
driver used for this by [RPiPlay](http://github.com/FD-/RPiPlay), in
|
||||
favor of v4l2 (Video4Linux2). Fixes to the GStreamer v4l2 plugin
|
||||
that allow it to work with UxPlay on RPi are now in the GStreamer
|
||||
usually has unacceptable latency, and hardware-accelerated GPU
|
||||
decoding should be used. The unmaintained 32-bit-only omx (OpenMAX)
|
||||
driver used for this by [RPiPlay](http://github.com/FD-/RPiPlay) is
|
||||
no longer officially supported by RPi OS (Bullseye): the replacement
|
||||
is v4l2 (Video4Linux2). Fixes to the GStreamer v4l2 plugin that
|
||||
allow it to work with UxPlay on RPi are now in the GStreamer
|
||||
development branch, and will be available in the upcoming
|
||||
GStreamer-1.22 release, A (partial) backport (as
|
||||
`gstreamer1.0-plugins-good-1.18.4-2+~rpt1`) has already appeared in
|
||||
|
||||
Reference in New Issue
Block a user