Skip to content

Commit

Permalink
README changes
Browse files Browse the repository at this point in the history
  • Loading branch information
@fduncanh
fduncanh committed Oct 4, 2024
1 parent b7734c5 commit 1a77a9f
Show file tree
Hide file tree
Showing 3 changed files with 29 additions and 52 deletions.
36 changes: 14 additions & 22 deletions README.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,21 +9,14 @@
(where ALL user issues should be posted, and latest versions can be
found).</strong></h3>
<ul>
<li><p><em><strong>NEW in v1.70</strong>: Support for 4k (h265) video
with the new “-h265” option.</em> (Recent Apple devices will send HEVC
(h265) video in AirPlay mirror mode if larger resolutions (<em>h</em>
&gt; 1080) are requested with UxPlay’s “-s wxh” option; wired ethernet
<li><em><strong>NEW in v1.70</strong>: Support for 4k (h265) video with
the new “-h265” option.</em> (Recent Apple devices will send HEVC (h265)
video in AirPlay mirror mode if larger resolutions (<em>h</em> &gt;
1080) are requested with UxPlay’s “-s wxh” option; wired ethernet
connection is prefered to wireless in this mode, and may also be
required by the client; the “-h265” option changes the default
resolution from 1920x1080 to 3840x2160, and leaves default maximum
framerate at 30fps.)</p></li>
<li><p><strong>An experimental (“beta”) version of UxPlay with support
for HLS streaming of YouTube Videos from the YouTube app on an iOS
client is now also available at</strong>
https://github.com/FDH2/UxPlay/tree/video2, and this feature will be
added in a future release of UxPlay. <em>See the <a
href="https://github.com/FDH2/UxPlay/wiki/experimental-version-of-UxPlay-with-support-for-HLS-video-streaming-(you-tube-movies)">Wiki
page</a> for details.</em></p></li>
resolution from 1920x1080 to 3840x2160, but leaves default maximum
framerate (“-fps option”) at 30fps.)</li>
</ul>
<h2 id="highlights">Highlights:</h2>
<ul>
Expand Down Expand Up @@ -646,13 +639,11 @@ <h3 id="starting-and-running-uxplay">Starting and running UxPlay</h3>
<li><p><strong>H265 (4K)</strong> video is supported with hardware
decoding by the Broadcom GPU on Raspberry Pi 5 models, as well as on
Raspberry Pi 4 model B. <strong>While GStreamer seem to make use of this
hardware decoding, satisfactory rendering of 4K video by UxPlay on these
Ras”pberry Pi models has not yet been acheived.</strong> The option
“-h265” is required for actvating h265 support, as well as a resolution
setting “-s wxh” with h &gt; 1080. A wired ethernet connection is
preferred in this mode (and may be required by the client) “<em>4K video
on Raspberry Pi is still a work in progress, and may require some
redesign of the video pipeline.</em>”</p></li>
hardware decoding, satisfactory rendering speed of 4K video by UxPlay on
these Raspberry Pi models has not yet been acheived.</strong> The option
“-h265” is required for actvating h265 support. A wired ethernet
connection is preferred in this mode (and may be required by the
client).</p></li>
</ul>
<p>Even with GPU video decoding, some frames may be dropped by the
lower-power models to keep audio and video synchronized using
Expand Down Expand Up @@ -1581,8 +1572,9 @@ <h3 id="mirror-screen-freezes-a-network-problem">5. Mirror screen
introduced 2017, running tvOS 12.2.1), so it does not seem to matter
what version UxPlay claims to be.</p>
<h1 id="changelog">Changelog</h1>
<p>1.70 2024-09-17 Add support for 4K (h265) video (resolution 3840 x
2160).</p>
<p>1.70 2024-10-04 Add support for 4K (h265) video (resolution 3840 x
2160). Fix issue with GStreamer &gt;= 1.24 when client sleeps, then
wakes.</p>
<p>1.69 2024-08-09 Internal improvements (e.g. in -nohold option,
identifying GStreamer videosink selected by autovideosink, finding X11
display) in anticipation of future HLS video support. New -nofreeze
Expand Down
17 changes: 6 additions & 11 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,8 @@
* _**NEW in v1.70**: Support for 4k (h265) video with the new "-h265" option._ (Recent Apple devices will send HEVC (h265) video in AirPlay mirror mode
if larger resolutions (_h_ > 1080) are requested with UxPlay's "-s wxh" option; wired ethernet connection is prefered to
wireless in this mode, and may also be required by the client;
the "-h265" option changes the default resolution from 1920x1080 to 3840x2160, and leaves default maximum framerate at 30fps.)
the "-h265" option changes the default resolution from 1920x1080 to 3840x2160, but leaves default maximum framerate ("-fps option") at 30fps.)

* **An experimental ("beta") version of UxPlay with support for HLS streaming of YouTube Videos from the YouTube
app on an iOS client is now also available at** https://github.com/FDH2/UxPlay/tree/video2, and this feature will be added in a future release of UxPlay.
_See the [Wiki page](https://github.com/FDH2/UxPlay/wiki/experimental-version-of-UxPlay-with-support-for-HLS-video-streaming-(you-tube-movies)) for details._

## Highlights:

* GPLv3, open source.
Expand Down Expand Up @@ -511,11 +507,9 @@ See [Usage](#usage) for more run-time options.
Raspberry Pi OS (Bullseye), but is present in Buster.

* **H265 (4K)** video is supported with hardware decoding by the Broadcom GPU on Raspberry Pi 5 models, as well as
on Raspberry Pi 4 model B. **While GStreamer seem to make use of this hardware decoding, satisfactory rendering of
4K video by UxPlay on these Ras"pberry Pi models has not yet been acheived.** The option "-h265" is required for actvating h265 support,
as well as a resolution setting "-s wxh" with h > 1080.
A wired ethernet connection is preferred in this mode (and may be required by the client)
"_4K video on Raspberry Pi is still a work in progress, and may require some redesign of the video pipeline._"
on Raspberry Pi 4 model B. **While GStreamer seem to make use of this hardware decoding, satisfactory rendering speed of
4K video by UxPlay on these Raspberry Pi models has not yet been acheived.** The option "-h265" is required for actvating h265 support.
A wired ethernet connection is preferred in this mode (and may be required by the client).

Even with GPU video decoding, some frames may be dropped by the lower-power models to keep audio and video synchronized
using timestamps. In Legacy Raspberry Pi OS (Bullseye), raspi-config "Performance Options" allows specifying how much memory
Expand Down Expand Up @@ -1235,7 +1229,8 @@ tvOS 12.2.1), so it does not seem to matter what version UxPlay claims to be.


# Changelog
1.70 2024-09-17 Add support for 4K (h265) video (resolution 3840 x 2160).
1.70 2024-10-04 Add support for 4K (h265) video (resolution 3840 x 2160). Fix issue
with GStreamer >= 1.24 when client sleeps, then wakes.

1.69 2024-08-09 Internal improvements (e.g. in -nohold option, identifying GStreamer videosink
selected by autovideosink, finding X11 display) in anticipation of future HLS video support.
Expand Down
28 changes: 9 additions & 19 deletions README.txt
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,8 @@
requested with UxPlay's "-s wxh" option; wired ethernet connection
is prefered to wireless in this mode, and may also be required by
the client; the "-h265" option changes the default resolution from
1920x1080 to 3840x2160, and leaves default maximum framerate at
30fps.)

- **An experimental ("beta") version of UxPlay with support for HLS
streaming of YouTube Videos from the YouTube app on an iOS client is
now also available at** https://github.com/FDH2/UxPlay/tree/video2,
and this feature will be added in a future release of UxPlay. *See
the [Wiki
page](https://github.com/FDH2/UxPlay/wiki/experimental-version-of-UxPlay-with-support-for-HLS-video-streaming-(you-tube-movies))
for details.*
1920x1080 to 3840x2160, but leaves default maximum framerate ("-fps
option") at 30fps.)

## Highlights:

Expand Down Expand Up @@ -643,13 +635,11 @@ See [Usage](#usage) for more run-time options.
- **H265 (4K)** video is supported with hardware decoding by the
Broadcom GPU on Raspberry Pi 5 models, as well as on Raspberry Pi 4
model B. **While GStreamer seem to make use of this hardware
decoding, satisfactory rendering of 4K video by UxPlay on these
Ras"pberry Pi models has not yet been acheived.** The option "-h265"
is required for actvating h265 support, as well as a resolution
setting "-s wxh" with h \> 1080. A wired ethernet connection is
preferred in this mode (and may be required by the client) "*4K
video on Raspberry Pi is still a work in progress, and may require
some redesign of the video pipeline.*"
decoding, satisfactory rendering speed of 4K video by UxPlay on
these Raspberry Pi models has not yet been acheived.** The option
"-h265" is required for actvating h265 support. A wired ethernet
connection is preferred in this mode (and may be required by the
client).

Even with GPU video decoding, some frames may be dropped by the
lower-power models to keep audio and video synchronized using
Expand Down Expand Up @@ -1621,8 +1611,8 @@ what version UxPlay claims to be.

# Changelog

1.70 2024-09-17 Add support for 4K (h265) video (resolution 3840 x
2160).
1.70 2024-10-04 Add support for 4K (h265) video (resolution 3840 x
2160). Fix issue with GStreamer \>= 1.24 when client sleeps, then wakes.

1.69 2024-08-09 Internal improvements (e.g. in -nohold option,
identifying GStreamer videosink selected by autovideosink, finding X11
Expand Down

0 comments on commit 1a77a9f

Please sign in to comment.