morgan/UxPlay
1
0
Fork 0
mirror of https://github.com/morgan9e/UxPlay synced 2026-04-14 00:04:13 +09:00
Code Issues Packages Projects Releases Wiki Activity

README updates

Browse Source
This commit is contained in:
F. Duncanh
2026-01-25 14:37:21 -05:00
parent 51db3ca3eb
commit f483365326
3 changed files with 4736 additions and 56 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
README.md
View File

@@ -2,7 +2,7 @@
### **Now developed at the GitHub site <https://github.com/FDH2/UxPlay> (where ALL user issues should be posted, and latest versions can be found).**
- **NEW in v1.73** (November 2025):
- **NEW in v1.73** (January 2026):
- Some YouTube app HLS videos now offer alternative language tracks (generated by AI dubbing). Language choices will be made in order of
preferences set with option -lang (or by environment variable $LANGUAGE, which "-lang" overrides). Format is `-lang fr:es:en`, where French ("fr") is
@@ -23,7 +23,8 @@
transmits rtp packets of decrypted h264 or h265 video to
an external renderer (e.g. OBS Studio) at an address specified in `rest-of-pipeline`.
Similarly, `-artp <rest-of-pipeline>` forwards decoded audio as L16 RTP packets.
Both options can be used together to forward video and audio (as separate concurrent streams) to external applications.
Both options can be used together to forward video and audio (as separate concurrent streams) to external
applications. See [Usage](#usage) for more details and sample Gstreamer receiver pipelines.
- (for Linux/*BSD Desktop Environments using D-Bus). New option `-scrsv <n>` provides screensaver inhibition (e.g., to
prevent screensaver function while watching mirrored videos without keyboard or mouse
@@ -1319,12 +1320,38 @@ superior-quality ALAC Apple Lossless audio in Airplay audio-only mode.
**-vrtp *pipeline***: forward rtp packets of decrypted video to somewhere else, without rendering.
Uses rtph264pay or rtph265pay as appropriate: *pipeline* should start with any
rtph26xpay options (such as config_interval= or aggregate-mode =), followed by
a sending method: *e.g.*, `"config-interval=1 ! udpsink host=127.0.0.1 port=5000`".
a sending method: *e.g.*, `"config-interval=1 ! udpsink host=127.0.0.1 port=XXXX`".
A gstreamer-based test receiver is
**-artp *pipeline***: forward decoded audio as L16 RTP packets to somewhere else, without local playback.
```
gst-launch-1.0 -v \
udpsrc port=XXXX \
! 'application/x-rtp, media=video, clock-rate=90000, encoding-name=H264, payload=96' \
! rtph264depay ! h264parse ! decodebin ! videoconvert !
autovideosink sync=false
_(Replace XXXX by the port you will use: make sure it is not blocked by a firewall; replace "264" by "265" if you are
streaming h265 video)._
```
* To use the -vrtp option with with OBS-studio, install the [obs-gstreamer](https://github.com/fzwoch/obs-gstreamer) plugin; after the
plugin installation,
the "+" icon in the OBS-studio "Sources" window will show an entry "GStreamer Source" where you should add the gstreamer decoder pipeline
"``udpsrc port=XXXX ! application/x-rtp,media=video,encoding-name=H264,payload=96 ! rtph264depay ! decodebin ! videoconvert ! video.``".
**-artp *pipeline***: forward decoded audio as L16 RTP packets (PCM format S16BE) to somewhere else, without rendering.
Uses rtpL16pay (16-bit signed big-endian PCM, 44100Hz stereo): *pipeline* should start with any
rtpL16pay options (such as pt=), followed by a sending method:
rtpL16pay options (such as pt=96), followed by a sending method:
*e.g.*, `"pt=96 ! udpsink host=127.0.0.1 port=5002"`. iOS volume control still works over RTP.
A gstreamer-based test receiver that plays the stream is
```
gst-launch-1.0 -v \
udpsrc port=5002 \
! application/x-rtp, media=audio, payload=96, clock-rate=44100, encoding-name=L16, format=S16BE, channels=2 \
! rtpL16depay ! audioconvert !
autoaudiosink sync=false
```
**-v4l2** Video settings for hardware h264 video decoding in the GPU by
Video4Linux2. Equivalent to `-vd v4l2h264dec -vc v4l2convert`.
@@ -1345,17 +1372,6 @@ release: it only occurs in Linux and \*BSD.
Linux and *BSD, but may be useless on Raspberry Pi, and may be unwanted,
as it adds extra processing load.
**-rpi** Equivalent to "-v4l2" (Not valid for Raspberry Pi model 5, and
removed in UxPlay 1.67)
**-rpigl** Equivalent to "-rpi -vs glimagesink". (Removed since UxPlay
1.67)
**-rpifb** Equivalent to "-rpi -vs kmssink" (Removed since UxPlay 1.67)
**-rpiwl** Equivalent to "-rpi -vs waylandsink". (Removed since UxPlay
1.67)
**-as *audiosink*** chooses the GStreamer audiosink, instead of letting
autoaudiosink pick it for you. Some audiosink choices are: pulsesink,
alsasink, pipewiresink, osssink, oss4sink, jackaudiosink, osxaudiosink
@@ -1950,7 +1966,7 @@ introduced 2017, running tvOS 12.2.1), so it does not seem to matter
what version UxPlay claims to be.
# Changelog
1.73 2025-11-10 Render Audio cover-art inside UxPlay with -ca option (no file
1.73 2026-01-25 Render Audio cover-art inside UxPlay with -ca option (no file
specified). (D-Bus based) option -scrsv <n> to inhibit screensaver while UxPlay
is running (Linux/*BSD only). Add password support (-pw) using a displayed
pin code as a password that changes every time (and not as a one-time