For NVIDIA graphics with the proprietary drivers, the nvdec plugin (recently renamed nvh264dec) can be used for accelerated video decoding on the NVIDIA GPU with CUDA. The nvdec plugin is part of gstreamer1.0-plugins-bad, but is generally not included in binary packages, as NVIDIA’s proprietary Video Codec SDK must be downloaded, and three header files from it must be added to the gstreamer source before the plugin can be compiled. Users must do this themselves: see these instructions, and adapt them as necessary for your GStreamer installation. This plugin should be used with the -vd nvdec (or nvh264dec) and -vs glimagesink uxplay options.
GPU Support for Raspberry Pi
-Raspberry Pi computers can run UxPlay with software decoding of h264 video (options uxplay -rpi -avdec) but this usually has unacceptible latency, and hardware-accelerated decoding by the Pi’s built-in Broadcom GPU should be used. UxPlay’s antecedent RPiPlay was developed to use the 32-bit-only omx (OpenMAX) driver for this, but omx has recently been declared obsolete and abandoned in “legacy” status by Raspberry Pi OS (Bullseye). The GStreamer plugin for its replacement v4l2 (Video4Linux2) has until recently been unusable with UxPlay, but new fixes in the GStreamer development branch have changed this. Backports (as patches) to GStreamer 1.18.4 (RPi OS Bullseye), 1.18.5 (Ubuntu 21.10) and 1.20.0 (Manjaro) are now available here, until distributions release them as updates, and work well with UxPlay, using a new option uxplay -rpi (tested on RPi model 4B). When using RPi OS Lite (no X11), use uxplay -rpi -vs kmssink.
Raspberry Pi (RPi) computers can run UxPlay with software decoding of h264 video (options uxplay -rpi -avdec) but this usually has unacceptible latency, and hardware-accelerated decoding by the Pi’s built-in Broadcom GPU should be used. RPi OS (Bullseye) has abandoned the omx (OpenMAX) driver used till now for this by RPiPlay, in favor of v4l2 (Video4Linux2). The GStreamer Video4Linux2 plugin only works with UxPlay since GStreamer-1.21.0.0 on the development branch, but a backport to 1.18.4 for RPi OS (Bullseye) has been created, and will appear in some future update. If you cannot wait for the update, you can find patching instructions in the UxPlay Wiki. Use the options uxplay -rpi ( or uxplay -rpi -vs kmssink on RPi OS Lite with no X11) with the patched GStreamer. Patches for GStreamer-1.18.5 (used in Ubuntu 21.10 for RPi) and GStreamer-1.20.0 (Used in Manjaro for RPi) are also available there.
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.
diff --git a/README.md b/README.md index 224d9f6..c2ac306 100644 --- a/README.md +++ b/README.md @@ -80,17 +80,18 @@ This plugin should be used with the `-vd nvdec` (or nvh264dec) and `-vs glimages * **GPU Support for Raspberry Pi** - Raspberry Pi computers can run UxPlay with software decoding of h264 video (options `uxplay -rpi -avdec`) but this usually + Raspberry Pi (RPi) computers can run UxPlay with software decoding of h264 video (options `uxplay -rpi -avdec`) but this usually has unacceptible latency, and hardware-accelerated decoding by the Pi's built-in Broadcom GPU should be used. - UxPlay's antecedent [RPiPlay](http://github.com/FD-/RPiPlay) was developed to use the 32-bit-only omx (OpenMAX) driver for this, but omx - has recently been declared obsolete and abandoned in "legacy" status by Raspberry Pi OS (Bullseye). The GStreamer plugin for its - replacement v4l2 (Video4Linux2) has until recently been unusable with UxPlay, but new fixes in the GStreamer development branch have - changed this. Backports (as patches) to GStreamer 1.18.4 (RPi OS Bullseye), 1.18.5 (Ubuntu 21.10) and 1.20.0 (Manjaro) are now - available [here](https://github.com/FDH2/UxPlay/issues/70), until distributions release them as updates, and work well with UxPlay, - using a new option `uxplay -rpi` (tested on RPi model 4B). When using RPi OS Lite (no X11), use `uxplay -rpi -vs kmssink`. + RPi OS (Bullseye) has abandoned the omx (OpenMAX) driver used till now for this by [RPiPlay](http://github.com/FD-/RPiPlay), in + favor of v4l2 (Video4Linux2). The GStreamer Video4Linux2 plugin only works with UxPlay since GStreamer-1.21.0.0 on the development branch, + but a backport to 1.18.4 for RPi OS (Bullseye) has been created, and will appear in some future update. If you cannot wait for the update, + you can find [patching instructions](https://github.com/FDH2/UxPlay/wiki/Gstreamer-Video4Linux2-plugin-patches) in + the [UxPlay Wiki](https://github.com/FDH2/UxPlay/wiki). Use the options `uxplay -rpi` ( + or `uxplay -rpi -vs kmssink` on RPi OS Lite with no X11) with the patched GStreamer. Patches for + GStreamer-1.18.5 (used in Ubuntu 21.10 for RPi) and GStreamer-1.20.0 (Used in Manjaro for RPi) are also available there. + ### Note to packagers: OpenSSL-3.0.0 solves GPL v3 license issues. - 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 diff --git a/README.txt b/README.txt index b77be16..b6f3068 100644 --- a/README.txt +++ b/README.txt @@ -104,22 +104,23 @@ uxplay options. - **GPU Support for Raspberry Pi** - Raspberry Pi computers can run UxPlay with software decoding of h264 - video (options `uxplay -rpi -avdec`) but this usually has + Raspberry Pi (RPi) computers can run UxPlay with software decoding + of h264 video (options `uxplay -rpi -avdec`) but this usually has unacceptible latency, and hardware-accelerated decoding by the Pi's - built-in Broadcom GPU should be used. UxPlay's antecedent - [RPiPlay](http://github.com/FD-/RPiPlay) was developed to use the - 32-bit-only omx (OpenMAX) driver for this, but omx has recently been - declared obsolete and abandoned in "legacy" status by Raspberry Pi - OS (Bullseye). The GStreamer plugin for its replacement v4l2 - (Video4Linux2) has until recently been unusable with UxPlay, but new - fixes in the GStreamer development branch have changed this. - Backports (as patches) to GStreamer 1.18.4 (RPi OS Bullseye), 1.18.5 - (Ubuntu 21.10) and 1.20.0 (Manjaro) are now available - [here](https://github.com/FDH2/UxPlay/issues/70), until - distributions release them as updates, and work well with UxPlay, - using a new option `uxplay -rpi` (tested on RPi model 4B). When - using RPi OS Lite (no X11), use `uxplay -rpi -vs kmssink`. + built-in Broadcom GPU should be used. RPi OS (Bullseye) has + abandoned the omx (OpenMAX) driver used till now for this by + [RPiPlay](http://github.com/FD-/RPiPlay), in favor of v4l2 + (Video4Linux2). The GStreamer Video4Linux2 plugin only works with + UxPlay since GStreamer-1.21.0.0 on the development branch, but a + backport to 1.18.4 for RPi OS (Bullseye) has been created, and will + appear in some future update. If you cannot wait for the update, you + can find [patching + instructions](https://github.com/FDH2/UxPlay/wiki/Gstreamer-Video4Linux2-plugin-patches) + in the [UxPlay Wiki](https://github.com/FDH2/UxPlay/wiki). Use the + options `uxplay -rpi` ( or `uxplay -rpi -vs kmssink` on RPi OS Lite + with no X11) with the patched GStreamer. Patches for + GStreamer-1.18.5 (used in Ubuntu 21.10 for RPi) and GStreamer-1.20.0 + (Used in Manjaro for RPi) are also available there. ### Note to packagers: OpenSSL-3.0.0 solves GPL v3 license issues.