mirror of
https://github.com/morgan9e/UxPlay
synced 2026-04-14 00:04:13 +09:00
edit README
This commit is contained in:
19
README.html
19
README.html
@@ -25,9 +25,9 @@ to select different hardware-appropriate output “videosinks” and
|
||||
pipeline).</li>
|
||||
<li>Support for server behind a firewall.</li>
|
||||
<li><strong>New</strong>: Support for Raspberry Pi, with hardware video
|
||||
acceleration by Video4Linux2 (replacement for 32-bit-only OpenMAX, which
|
||||
is no longer supported by Raspberry Pi OS). (For GStreamer < 1.22, a
|
||||
<a
|
||||
acceleration by Video4Linux2 (the replacement for 32-bit-only OpenMAX,
|
||||
now unsupported by recent Raspberry Pi distributions). (For GStreamer
|
||||
< 1.22, 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,
|
||||
@@ -37,7 +37,7 @@ href="https://github.com/FDH2/UxPlay/wiki/UxPlay-on-Raspberry-Pi:-success-report
|
||||
reports</a>.</li>
|
||||
</ul>
|
||||
<p>This project is a GPLv3 open source unix AirPlay2 Mirror server for
|
||||
Linux, macOS, and *BSD. It was initially developed by <a
|
||||
Linux, macOS, and *BSD. It was initially developed by555555555555555 <a
|
||||
href="http://github.com/antimof/Uxplay">antimof</a> using code from <a
|
||||
href="https://github.com/FD-/RPiPlay">RPiPlay</a>, which in turn derives
|
||||
from <a
|
||||
@@ -58,7 +58,7 @@ audio) of iOS/iPadOS/macOS clients (iPhones, iPads, MacBooks) in a
|
||||
window on the server display (with the possibility of sharing that
|
||||
window on screen-sharing applications such as Zoom) on a host running
|
||||
Linux, macOS, or other unix. UxPlay supports Apple’s AirPlay 2 protocol
|
||||
using “Legacy Pairing”, and some features are missing. (Details of what
|
||||
using “Legacy Pairing”, but some features are missing. (Details of what
|
||||
is publically known about Apple’s AirPlay 2 protocol can be found <a
|
||||
href="https://github.com/SteeBono/airplayreceiver/wiki/AirPlay2-Protocol">here</a>
|
||||
and <a href="https://emanuelecozzi.net/docs/airplay2">here</a>).</p>
|
||||
@@ -92,7 +92,7 @@ the server.</strong></li>
|
||||
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
|
||||
“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,
|
||||
@@ -100,10 +100,9 @@ software decoding is used.</p>
|
||||
<ul>
|
||||
<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
|
||||
<p>With an Intel or AMD GPU, hardware decoding with the 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>
|
||||
|
||||
40
README.md
40
README.md
@@ -21,8 +21,8 @@ Highlights:
|
||||
"audiosinks", and a fully-user-configurable video streaming pipeline).
|
||||
* Support for server behind a firewall.
|
||||
* **New**: Support for Raspberry Pi, with hardware video acceleration by
|
||||
Video4Linux2 (replacement for 32-bit-only OpenMAX, which is no longer
|
||||
supported by Raspberry Pi OS). (For GStreamer < 1.22,
|
||||
Video4Linux2 (the replacement for 32-bit-only OpenMAX, now unsupported by
|
||||
recent Raspberry Pi distributions). (For GStreamer < 1.22,
|
||||
a [patch](https://github.com/FDH2/UxPlay/wiki/Gstreamer-Video4Linux2-plugin-patches)
|
||||
to the GStreamer Video4Linux2 plugin, available in the
|
||||
[UxPlay Wiki](https://github.com/FDH2/UxPlay/wiki), is required, unless
|
||||
@@ -31,7 +31,7 @@ Highlights:
|
||||
See [success reports](https://github.com/FDH2/UxPlay/wiki/UxPlay-on-Raspberry-Pi:-success-reports:).
|
||||
|
||||
This project is a GPLv3 open source unix AirPlay2 Mirror server for Linux, macOS, and \*BSD.
|
||||
It was initially developed by
|
||||
It was initially developed by555555555555555
|
||||
[antimof](http://github.com/antimof/Uxplay) using code
|
||||
from [RPiPlay](https://github.com/FD-/RPiPlay), which in turn derives from
|
||||
[AirplayServer](https://github.com/KqsMea8/AirplayServer),
|
||||
@@ -47,7 +47,8 @@ Its main use is to act like an AppleTV for screen-mirroring (with audio) of iOS/
|
||||
(iPhones, iPads, MacBooks) in a window
|
||||
on the server display (with the possibility of
|
||||
sharing that window on screen-sharing applications such as Zoom)
|
||||
on a host running Linux, macOS, or other unix. UxPlay supports Apple's AirPlay 2 protocol using "Legacy Pairing", and some features are missing.
|
||||
on a host running Linux, macOS, or other unix. UxPlay supports Apple's AirPlay 2
|
||||
protocol using "Legacy Pairing", but some features are missing.
|
||||
(Details of what is publically known about Apple's AirPlay 2 protocol can be found
|
||||
[here](https://github.com/SteeBono/airplayreceiver/wiki/AirPlay2-Protocol) and
|
||||
[here](https://emanuelecozzi.net/docs/airplay2)).
|
||||
@@ -79,17 +80,19 @@ streaming it to the client, and then re-streaming to the server.**
|
||||
|
||||
### Possibility for using hardware-accelerated h264 video-decoding, if available.
|
||||
|
||||
UxPlay uses [GStreamer](https://gstreamer.freedesktop.org) 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.
|
||||
UxPlay uses [GStreamer](https://gstreamer.freedesktop.org) "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.
|
||||
|
||||
* **VAAPI for Intel and AMD integrated graphics, NVIDIA with "Nouveau" open-source driver**
|
||||
|
||||
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.
|
||||
With an Intel or AMD GPU, hardware decoding with the 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.
|
||||
|
||||
* **NVIDIA with proprietary drivers**
|
||||
|
||||
@@ -106,13 +109,12 @@ h264 decoders if available; if not, software decoding is used.
|
||||
* **Video4Linux2 support for the Raspberry Pi Broadcom GPU**
|
||||
|
||||
Raspberry Pi (RPi) computers can run UxPlay with software decoding
|
||||
of h264 video but this
|
||||
usually has unacceptable latency, and hardware-accelerated GPU decoding
|
||||
should be used. Distributions such as RPi OS (Bullseye) release have
|
||||
recently dropped support for 32-bit-only OpenMAX (omx) GPU decoding (used by RPiPlay), in
|
||||
favor of Video4Linux2 (v4l2). Fixes to the GStreamer 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.
|
||||
of h264 video but this usually has unacceptable latency, and hardware-accelerated
|
||||
GPU decoding should be used. Distributions such as RPi OS (Bullseye) release have
|
||||
recently dropped support for 32-bit-only OpenMAX (omx) GPU decoding (used by RPiPlay),
|
||||
in favor of Video4Linux2 (v4l2). Fixes to the GStreamer 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 `gstreamer1.0-plugins-good-1.18.4-2+~rpt1`)
|
||||
has already appeared in RPi OS updates. Until the full update
|
||||
appears, or for other distributions, you can find
|
||||
|
||||
20
README.txt
20
README.txt
@@ -21,8 +21,9 @@ Highlights:
|
||||
pipeline).
|
||||
- Support for server behind a firewall.
|
||||
- **New**: Support for Raspberry Pi, with hardware video acceleration
|
||||
by Video4Linux2 (replacement for 32-bit-only OpenMAX, which is no
|
||||
longer supported by Raspberry Pi OS). (For GStreamer \< 1.22, a
|
||||
by Video4Linux2 (the replacement for 32-bit-only OpenMAX, now
|
||||
unsupported by recent Raspberry Pi distributions). (For GStreamer \<
|
||||
1.22, a
|
||||
[patch](https://github.com/FDH2/UxPlay/wiki/Gstreamer-Video4Linux2-plugin-patches)
|
||||
to the GStreamer Video4Linux2 plugin, available in the [UxPlay
|
||||
Wiki](https://github.com/FDH2/UxPlay/wiki), is required, unless your
|
||||
@@ -31,7 +32,7 @@ Highlights:
|
||||
reports](https://github.com/FDH2/UxPlay/wiki/UxPlay-on-Raspberry-Pi:-success-reports:).
|
||||
|
||||
This project is a GPLv3 open source unix AirPlay2 Mirror server for
|
||||
Linux, macOS, and \*BSD. It was initially developed by
|
||||
Linux, macOS, and \*BSD. It was initially developed by555555555555555
|
||||
[antimof](http://github.com/antimof/Uxplay) using code from
|
||||
[RPiPlay](https://github.com/FD-/RPiPlay), which in turn derives from
|
||||
[AirplayServer](https://github.com/KqsMea8/AirplayServer),
|
||||
@@ -52,7 +53,7 @@ of iOS/iPadOS/macOS clients (iPhones, iPads, MacBooks) in a window on
|
||||
the server display (with the possibility of sharing that window on
|
||||
screen-sharing applications such as Zoom) on a host running Linux,
|
||||
macOS, or other unix. UxPlay supports Apple's AirPlay 2 protocol using
|
||||
"Legacy Pairing", and some features are missing. (Details of what is
|
||||
"Legacy Pairing", but some features are missing. (Details of what is
|
||||
publically known about Apple's AirPlay 2 protocol can be found
|
||||
[here](https://github.com/SteeBono/airplayreceiver/wiki/AirPlay2-Protocol)
|
||||
and [here](https://emanuelecozzi.net/docs/airplay2)).
|
||||
@@ -85,8 +86,8 @@ Mirror mode connection.*
|
||||
|
||||
### Possibility for using hardware-accelerated h264 video-decoding, if available.
|
||||
|
||||
UxPlay uses [GStreamer](https://gstreamer.freedesktop.org) Plugins for
|
||||
rendering audio and video, This means that video and audio are supported
|
||||
UxPlay uses [GStreamer](https://gstreamer.freedesktop.org) "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
|
||||
@@ -95,10 +96,9 @@ used.
|
||||
- **VAAPI for Intel and AMD integrated graphics, NVIDIA with "Nouveau"
|
||||
open-source driver**
|
||||
|
||||
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
|
||||
With an Intel or AMD GPU, hardware decoding with the 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.
|
||||
|
||||
Reference in New Issue
Block a user