README update about R Pi OS Legacy (Buster)

2026-04-14 00:04:13 +09:00 · 2023-06-16 04:16:16 -04:00
parent c50a3bcf21
commit d6f0d0227e
3 changed files with 105 additions and 34 deletions
--- a/README.html
+++ b/README.html
@@ -232,6 +232,16 @@ README). If you have a non-standard OpenSSL installation, you may need
 to set the environment variable OPENSSL_ROOT_DIR (<em>e.g.</em> ,
 “<code>export OPENSSL_ROOT_DIR=/usr/local/lib64</code>” if that is where
 it is installed).</p>
+<ul>
+<li>Most users will use the GStreamer supplied by their distribution,
+but a few (in particular users of Raspberry Pi OS Lite Legacy (Buster)
+on a Raspberry Pi model 4B who wish to stay on that unsupported Legacy
+OS for compatibility with other apps) should instead build a newer
+Gstreamer from source following <a
+href="https://github.com/FDH2/UxPlay/wiki/Building-latest-GStreamer-from-source-on-distributions-with-older-GStreamer-(e.g.-Raspberry-Pi-OS-).">these
+instructions</a> . <strong>Do this <em>before</em> building
+UxPlay</strong>.</li>
+</ul>
 <p>In a terminal window, change directories to the source directory of
 the downloaded source code (“UxPlay-*”, “*” = “master” or the release
 tag for zipfile downloads, “UxPlay” for “git clone” downloads), then
@@ -254,15 +264,18 @@ UxPlay <em>without</em> any X11 dependence, use the cmake option
 <code>-DNO_X11_DEPS=ON</code>.</li>
 </ul>
 <ol type="1">
-<li><code>sudo apt-get install libssl-dev libplist-dev</code>“. (unless
-you need to build OpenSSL and libplist from source).</li>
-<li><code>sudo apt-get install libavahi-compat-libdnssd-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev</code>.</li>
-<li><code>cmake .</code> (For a cleaner build, which is useful if you
-modify the source, replace this by
-“<code>mkdir build; cd build; cmake ..</code>”: you can then delete the
-<code>build</code> directory if needed, without affecting the source.)
-Also add any cmake “<code>-D</code>” options here as needed (e.g,
-<code>-DNO_X11_DEPS=ON</code> or
+<li><code>sudo apt-get install libssl-dev libplist-dev</code>“.
+(<em>unless you need to build OpenSSL and libplist from
+source</em>).</li>
+<li><code>sudo apt-get install libavahi-compat-libdnssd-dev</code></li>
+<li><code>sudo apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev</code>.
+(*<em>Skip if you built Gstreamer from source</em>)</li>
+<li><code>cmake .</code> (<em>For a cleaner build, which is useful if
+you modify the source, replace this by</em>
+“<code>mkdir build; cd build; cmake ..</code>”: <em>you can then delete
+the contents of the <code>build</code> directory if needed, without
+affecting the source.</em>) Also add any cmake “<code>-D</code>” options
+here as needed (e.g, <code>-DNO_X11_DEPS=ON</code> or
 <code>-DNO_MARCH_NATIVE=ON</code>).</li>
 <li><code>make</code></li>
 <li><code>sudo make install</code> (you can afterwards uninstall with
@@ -301,8 +314,10 @@ the dns_sd library. OpenSSL is already installed as a System
 Library.</p></li>
 </ul>
 <h2 id="running-uxplay">Running UxPlay</h2>
-<h3 id="installing-plugins-debian-based-linux-systems">Installing
-plugins (Debian-based Linux systems)</h3>
+<h3
+id="installing-plugins-debian-based-linux-systems-skip-if-you-built-a-complete-gstreamer-from-source">Installing
+plugins (Debian-based Linux systems) (<em>skip if you built a complete
+GStreamer from source</em>)</h3>
 <p>Next install the GStreamer plugins that are needed with
 <code>sudo apt-get install gstreamer1.0-&lt;plugin&gt;</code>. Values of
 <code>&lt;plugin&gt;</code> required are:</p>
@@ -327,8 +342,10 @@ on how your audio is set up.</p>
 <li>Also install “<strong>gstreamer1.0-tools</strong>” to get the
 utility gst-inspect-1.0 for examining the GStreamer installation.</li>
 </ul>
-<h3 id="installing-plugins-non-debian-based-linux-or-bsd">Installing
-plugins (Non-Debian-based Linux or *BSD)</h3>
+<h3
+id="installing-plugins-non-debian-based-linux-or-bsd-skip-if-you-built-a-complete-gstreamer-from-source">Installing
+plugins (Non-Debian-based Linux or *BSD) (<em>skip if you built a
+complete GStreamer from source</em>)</h3>
 <ul>
 <li><p><strong>Red Hat, or clones like CentOS (now continued as Rocky
 Linux or Alma Linux):</strong> (sudo dnf install, or sudo yum install)
@@ -493,6 +510,18 @@ it include Raspberry Pi OS, Ubuntu, and Manjaro (all available from
 Raspberry Pi with their Raspberry Pi Imager). Other distributions
 generally do not provide it: <strong>without this kernel module, UxPlay
 cannot use the decoding firmware in the GPU.</strong></p></li>
+<li><p>On a Raspberry Pi model 4B running the unsupported “Legacy” R Pi
+OS (Buster), note that this comes with a very old GStreamer-1.14.4
+<strong>that cannot be patched to access the Broadcom GPU</strong>. If
+you need to stay on the unsupported “Legacy” OS (“Lite” version), but
+want to use UxPlay with hardware video decoding, you need to first build
+a complete newer GStreamer from source using <a
+href="https://github.com/FDH2/UxPlay/wiki/Building-latest-GStreamer-from-source-on-distributions-with-older-GStreamer-(e.g.-Raspberry-Pi-OS-).">these
+instructions</a> before building UxPlay. Note that a model 3B+ Pi
+running the Legacy OS can access the GPU with GStreamer-1.14’s omx
+plugin (use option “<code>-vd omxh264dec</code>”), but this plugin is
+broken on model 4B’s firmware, and omx support was removed in R Pi OS
+(Bullseye).</p></li>
 </ul>
 <p>For use of the GPU, use raspi-config “Performance Options” (on
 Raspberry Pi OS, use a similar tool on other distributions) to allocate
--- a/README.md
+++ b/README.md
@@ -193,6 +193,14 @@ source (see instructions at the end of this README).  If you have a non-standard
 installation, you may need to set the environment variable OPENSSL_ROOT_DIR
 (_e.g._ , "`export OPENSSL_ROOT_DIR=/usr/local/lib64`" if that is where it is installed).

+* Most users will use the GStreamer supplied by their distribution, but a few (in particular users
+of Raspberry Pi OS Lite Legacy (Buster) on a Raspberry Pi model 4B who wish to stay on that
+unsupported Legacy OS for compatibility with other apps) should instead build a newer Gstreamer from source
+following  [these instructions](https://github.com/FDH2/UxPlay/wiki/Building-latest-GStreamer-from-source-on-distributions-with-older-GStreamer-(e.g.-Raspberry-Pi-OS-).) . **Do this
+_before_ building UxPlay**.
+
+
+
 In a terminal window, change directories to the source directory of the
 downloaded source code ("UxPlay-\*", "\*" = "master" or the release tag for
 zipfile downloads, "UxPlay" for "git clone" downloads), then follow the instructions below:
@@ -213,14 +221,15 @@ wish to build UxPlay *without* any X11 dependence, use
 the cmake option `-DNO_X11_DEPS=ON`.

 1. `sudo apt-get install libssl-dev libplist-dev`".
-    (unless you need to build OpenSSL and libplist from source).
-2.  `sudo apt-get install libavahi-compat-libdnssd-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev`. 
-3.  `cmake .` (For a cleaner build, which is useful if you modify the source, replace this 
-    by "``mkdir build; cd build; cmake ..``": you can then delete the
-    `build` directory if needed, without affecting the source.)   Also add any cmake "`-D`" options
+    (_unless you need to build OpenSSL and libplist from source_).
+2.  `sudo apt-get install libavahi-compat-libdnssd-dev`
+3.  `sudo apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev`. (\*_Skip if you built Gstreamer from source_)
+4.  `cmake .` (_For a cleaner build, which is useful if you modify the source, replace this 
+    by_ "``mkdir build; cd build; cmake ..``": _you can then delete the contents of the
+    `build` directory if needed, without affecting the source._)   Also add any cmake "`-D`" options
    here as needed (e.g, `-DNO_X11_DEPS=ON` or ``-DNO_MARCH_NATIVE=ON``).
-4. `make`
-5. `sudo make install` (you can afterwards uninstall with ``sudo make uninstall``
+5. `make`
+6. `sudo make install` (you can afterwards uninstall with ``sudo make uninstall``
    in the same directory in which this was run).

 This installs the executable file "`uxplay`" to `/usr/local/bin`, (and installs a manpage to
@@ -231,6 +240,8 @@ The uxplay executable  can also be found in the build directory after the build
 process, if you wish to test before installing (in which case
 the GStreamer plugins must first be installed).

+
+
 ### Building on  non-Debian Linux and \*BSD

 * **Red Hat, or clones like CentOS (now continued as Rocky Linux or Alma Linux):** 
@@ -255,7 +266,7 @@ OpenSSL is already installed as a System Library.

 ## Running UxPlay

-### Installing plugins (Debian-based Linux systems)
+### Installing plugins (Debian-based Linux systems) (_skip if you built a complete GStreamer from source_)

 Next install the GStreamer plugins that are needed with `sudo apt-get install gstreamer1.0-<plugin>`.
 Values of `<plugin>` required are: 
@@ -276,7 +287,7 @@ installed, depending on how your audio is set up.
 * Also install "**gstreamer1.0-tools**" to get the utility gst-inspect-1.0 for examining the GStreamer installation.  


-### Installing plugins (Non-Debian-based Linux or \*BSD)
+### Installing plugins (Non-Debian-based Linux or \*BSD) (_skip if you built a complete GStreamer from source_)

 * **Red Hat, or clones like CentOS (now continued as Rocky Linux or Alma Linux):** 
 (sudo dnf install, or sudo yum install) gstreamer1-libav gstreamer1-plugins-bad-free (+ gstreamer1-vaapi
@@ -405,6 +416,15 @@ only distributions for R Pi that are known to supply it include Raspberry Pi OS,
 from Raspberry Pi with their Raspberry Pi Imager).  Other distributions generally do not
 provide it: **without this kernel module, UxPlay cannot use the decoding firmware in the GPU.**

+* On a  Raspberry Pi model 4B running the unsupported "Legacy" R Pi OS (Buster), note that 
+this comes with a very old GStreamer-1.14.4 **that cannot be patched to access the  Broadcom GPU**.  If you need to stay on the unsupported
+"Legacy" OS ("Lite" version), but want to use UxPlay with hardware video decoding,  you need
+to first build a complete newer GStreamer from source
+using [these instructions](https://github.com/FDH2/UxPlay/wiki/Building-latest-GStreamer-from-source-on-distributions-with-older-GStreamer-(e.g.-Raspberry-Pi-OS-).)
+before building UxPlay. Note that a model 3B+ Pi running the Legacy OS can access the GPU with GStreamer-1.14's omx plugin (use option "`-vd omxh264dec`"), but
+this plugin is broken on model 4B's firmware, and omx support was removed in  R Pi OS (Bullseye).
+
+
 For use of the GPU, use raspi-config "Performance Options" (on Raspberry Pi OS, use a similar tool on other
 distributions) to allocate sufficient memory for the GPU (on  R. Pi 3 model B+, the maximum (256MB) is suggested).
 Even with GPU video decoding, some frames may be dropped by the lower-power 3 B+  to keep audio and video synchronized
--- a/README.txt
+++ b/README.txt
@@ -233,6 +233,14 @@ to set the environment variable OPENSSL_ROOT_DIR (*e.g.* ,
 "`export OPENSSL_ROOT_DIR=/usr/local/lib64`" if that is where it is
 installed).

+-   Most users will use the GStreamer supplied by their distribution,
+    but a few (in particular users of Raspberry Pi OS Lite Legacy
+    (Buster) on a Raspberry Pi model 4B who wish to stay on that
+    unsupported Legacy OS for compatibility with other apps) should
+    instead build a newer Gstreamer from source following [these
+    instructions](https://github.com/FDH2/UxPlay/wiki/Building-latest-GStreamer-from-source-on-distributions-with-older-GStreamer-(e.g.-Raspberry-Pi-OS-).)
+    . **Do this *before* building UxPlay**.
+
 In a terminal window, change directories to the source directory of the
 downloaded source code ("UxPlay-\*", "\*" = "master" or the release tag
 for zipfile downloads, "UxPlay" for "git clone" downloads), then follow
@@ -255,16 +263,18 @@ GStreamer \< 1.20 is detected, a fix needed by screen-sharing apps
    UxPlay *without* any X11 dependence, use the cmake option
    `-DNO_X11_DEPS=ON`.

-1.  `sudo apt-get install libssl-dev libplist-dev`". (unless you need to
-    build OpenSSL and libplist from source).
-2.  `sudo apt-get install libavahi-compat-libdnssd-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev`.
-3.  `cmake .` (For a cleaner build, which is useful if you modify the
-    source, replace this by "`mkdir build; cd build; cmake ..`": you can
-    then delete the `build` directory if needed, without affecting the
-    source.) Also add any cmake "`-D`" options here as needed (e.g,
-    `-DNO_X11_DEPS=ON` or `-DNO_MARCH_NATIVE=ON`).
-4.  `make`
-5.  `sudo make install` (you can afterwards uninstall with
+1.  `sudo apt-get install libssl-dev libplist-dev`". (*unless you need
+    to build OpenSSL and libplist from source*).
+2.  `sudo apt-get install libavahi-compat-libdnssd-dev`
+3.  `sudo apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev`.
+    (\**Skip if you built Gstreamer from source*)
+4.  `cmake .` (*For a cleaner build, which is useful if you modify the
+    source, replace this by* "`mkdir build; cd build; cmake ..`": *you
+    can then delete the contents of the `build` directory if needed,
+    without affecting the source.*) Also add any cmake "`-D`" options
+    here as needed (e.g, `-DNO_X11_DEPS=ON` or `-DNO_MARCH_NATIVE=ON`).
+5.  `make`
+6.  `sudo make install` (you can afterwards uninstall with
    `sudo make uninstall` in the same directory in which this was run).

 This installs the executable file "`uxplay`" to `/usr/local/bin`, (and
@@ -300,7 +310,7 @@ GStreamer plugins must first be installed).

 ## Running UxPlay

-### Installing plugins (Debian-based Linux systems)
+### Installing plugins (Debian-based Linux systems) (*skip if you built a complete GStreamer from source*)

 Next install the GStreamer plugins that are needed with
 `sudo apt-get install gstreamer1.0-<plugin>`. Values of `<plugin>`
@@ -323,7 +333,7 @@ installed, depending on how your audio is set up.
 -   Also install "**gstreamer1.0-tools**" to get the utility
    gst-inspect-1.0 for examining the GStreamer installation.

-### Installing plugins (Non-Debian-based Linux or \*BSD)
+### Installing plugins (Non-Debian-based Linux or \*BSD) (*skip if you built a complete GStreamer from source*)

 -   **Red Hat, or clones like CentOS (now continued as Rocky Linux or
    Alma Linux):** (sudo dnf install, or sudo yum install)
@@ -493,6 +503,18 @@ See [Usage](#usage) for more run-time options.
    provide it: **without this kernel module, UxPlay cannot use the
    decoding firmware in the GPU.**

+-   On a Raspberry Pi model 4B running the unsupported "Legacy" R Pi OS
+    (Buster), note that this comes with a very old GStreamer-1.14.4
+    **that cannot be patched to access the Broadcom GPU**. If you need
+    to stay on the unsupported "Legacy" OS ("Lite" version), but want to
+    use UxPlay with hardware video decoding, you need to first build a
+    complete newer GStreamer from source using [these
+    instructions](https://github.com/FDH2/UxPlay/wiki/Building-latest-GStreamer-from-source-on-distributions-with-older-GStreamer-(e.g.-Raspberry-Pi-OS-).)
+    before building UxPlay. Note that a model 3B+ Pi running the Legacy
+    OS can access the GPU with GStreamer-1.14's omx plugin (use option
+    "`-vd omxh264dec`"), but this plugin is broken on model 4B's
+    firmware, and omx support was removed in R Pi OS (Bullseye).
+
 For use of the GPU, use raspi-config "Performance Options" (on Raspberry
 Pi OS, use a similar tool on other distributions) to allocate sufficient
 memory for the GPU (on R. Pi 3 model B+, the maximum (256MB) is