https://github.com/agx/livi
Minimalistic video player for mobile devices using GTK4, libadwaita and gstreamer
https://github.com/agx/livi
gstreamer gtk4 hantro librem5 video-player
Last synced: 4 months ago
JSON representation
Minimalistic video player for mobile devices using GTK4, libadwaita and gstreamer
- Host: GitHub
- URL: https://github.com/agx/livi
- Owner: agx
- License: gpl-3.0
- Created: 2021-07-07T15:11:56.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-11T21:47:28.000Z (5 months ago)
- Last Synced: 2024-12-24T02:53:13.055Z (4 months ago)
- Topics: gstreamer, gtk4, hantro, librem5, video-player
- Language: C
- Homepage:
- Size: 1.47 MB
- Stars: 6
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS
- License: COPYING
Awesome Lists containing this project
- awesome-gtk - livi - Minimalistic video player for mobile devices powered by GStreamer `#c` `#gtk4` `#libadwaita`. (Video / Video Players)
README
Light Video
===========
Minimalist video player using GTK4, libadwaita and GStreamer. The main
purpose is to make playing hardware accelerated videos with e.g. hantro and
OpenGL simple.
It supports:
- Inhibiting suspend/idle when playing video
- Stopping video playback on (i.e. power button toggled) blank
- Registering as default video player in GNOME control center
- A [MPRIS interface][] to control the playback
- Resuming position on previously played videos
- Playing videos from popular online sites using [yt-dlp][] as "preprocessor".
Building
========
Flatpak build:
```sh
# Intial setup
flatpak install --user org.gnome.Sdk//master
flatpak install --user org.gnome.Platform//master
# Build
flatpak-builder --force-clean --install --user _build/ org.sigxcpu.Livi.json
```
Regular build:
```sh
# Intial setup
apt build-dep .
# Build
meson setup . _build
meson compile -C _build
```
Using
=====
To play a video using the preprocessor use `-Y`:
```sh
livi -Y
```
For this to work `yt-dlp` needs to be able to fetch a combined audio and
video stream. If this is possible for a given URL with the current `yt-dlp`
configuration can be checked with:
```sh
yt-dlp --list-formats
```
At least one of the listed format there needs to contain a video *and*
audio stream as you'd otherwise get video playback without audio when
playing the URL in livi.
You can wiggle `yt-dlp` option to see if you can find a combined
format. Common options there are `--format-sort` and
`--extractor-args`. Once you've found suitable options you can put
them into `~/.config/yt-dlp.conf. E.g.
```sh
cat < ~/.config/yt-dlp.conf
--format-sort=codec:h264,codec:vp8
--extractor-args=youtube:player-client=android
EOF
```
[MPRIS interface]: https://specifications.freedesktop.org/mpris-spec/
[yt-dlp]: https://github.com/yt-dlp/yt-dlp