detached ec9a433

docs(readme): update GStreamer hardware video decoding requirements

commit
ec9a4338da044072e0bfb96c25d7b0629a9bf8be
author
brice · · 2025-12-16 22:13 UTC
committer
brice · · 2025-12-16 22:48 UTC
parent
1e2eafb
signature
unsigned
1 file · +14 -8
M README.md +14 -8
@@ -158,10 +158,13 @@ sudo pacman -S webkitgtk-6.0 gtk4
158158 # GStreamer for media playback
159159 sudo pacman -S gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav gst-plugin-pipewire pipewire pipewire-pulse
160160
161-# Hardware acceleration (choose based on your GPU)
162-# AMD: sudo pacman -S gstreamer-vaapi mesa
163-# NVIDIA: sudo pacman -S gstreamer-vaapi libva-nvidia-driver
164-# Intel: sudo pacman -S gstreamer-vaapi libva-intel-driver intel-media-driver
161+# Hardware video decoding (required for YouTube, Twitch, etc.)
162+sudo pacman -S gst-plugin-va
163+
164+# VA-API drivers (choose based on your GPU)
165+# AMD: sudo pacman -S libva-mesa-driver mesa
166+# NVIDIA: sudo pacman -S libva-nvidia-driver
167+# Intel: sudo pacman -S libva-intel-driver intel-media-driver
165168 ```
166169
167170 **Debian/Ubuntu:**
@@ -175,8 +178,9 @@ sudo apt install libwebkitgtk-6.0-4 libgtk-4-1
175178 # GStreamer for media playback
176179 sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-pipewire
177180
178-# Hardware acceleration
179-sudo apt install gstreamer1.0-vaapi va-driver-all
181+# Hardware video decoding (gst-plugins-bad includes VA stateless decoders)
182+# VA-API drivers
183+sudo apt install va-driver-all
180184 ```
181185
182186 ### Build From Source
@@ -296,10 +300,12 @@ WebKitGTK uses GStreamer for media playback. Dumber includes automatic hardware
296300 **Required packages:**
297301 - Arch Linux:
298302 - `sudo pacman -S gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav gst-plugin-pipewire pipewire pipewire-pulse`
299- - Hardware accel: `gstreamer-vaapi mesa` (AMD), `libva-nvidia-driver` (NVIDIA), `libva-intel-driver intel-media-driver` (Intel)
303+ - Hardware decoding: `gst-plugin-va` (stateless VA decoders - required for WebKitGTK)
304+ - VA-API drivers: `libva-mesa-driver mesa` (AMD), `libva-nvidia-driver` (NVIDIA), `libva-intel-driver intel-media-driver` (Intel)
300305 - Debian/Ubuntu:
301306 - `sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-pipewire`
302- - Hardware accel: `gstreamer1.0-vaapi va-driver-all` (covers most GPUs)
307+ - Hardware decoding: `gstreamer1.0-plugins-bad` includes VA stateless decoders
308+ - VA-API drivers: `va-driver-all` (covers most GPUs)
303309
304310 ## Contribute
305311 I will gladly accept contributions, especially related to UI/UX enhancements. Feel free to open an issue and let's discuss it!
@@ -158,10 +158,13 @@ sudo pacman -S webkitgtk-6.0 gtk4
158 # GStreamer for media playback158 # GStreamer for media playback
159 sudo pacman -S gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav gst-plugin-pipewire pipewire pipewire-pulse159 sudo pacman -S gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav gst-plugin-pipewire pipewire pipewire-pulse
160 160
161-# Hardware acceleration (choose based on your GPU)161+# Hardware video decoding (required for YouTube, Twitch, etc.)
162-# AMD: sudo pacman -S gstreamer-vaapi mesa162+sudo pacman -S gst-plugin-va
163-# NVIDIA: sudo pacman -S gstreamer-vaapi libva-nvidia-driver163+
164-# Intel: sudo pacman -S gstreamer-vaapi libva-intel-driver intel-media-driver164+# VA-API drivers (choose based on your GPU)
165+# AMD: sudo pacman -S libva-mesa-driver mesa
166+# NVIDIA: sudo pacman -S libva-nvidia-driver
167+# Intel: sudo pacman -S libva-intel-driver intel-media-driver
165 ```168 ```
166 169
167 **Debian/Ubuntu:**170 **Debian/Ubuntu:**
@@ -175,8 +178,9 @@ sudo apt install libwebkitgtk-6.0-4 libgtk-4-1
175 # GStreamer for media playback178 # GStreamer for media playback
176 sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-pipewire179 sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-pipewire
177 180
178-# Hardware acceleration181+# Hardware video decoding (gst-plugins-bad includes VA stateless decoders)
179-sudo apt install gstreamer1.0-vaapi va-driver-all182+# VA-API drivers
183+sudo apt install va-driver-all
180 ```184 ```
181 185
182 ### Build From Source186 ### Build From Source
@@ -296,10 +300,12 @@ WebKitGTK uses GStreamer for media playback. Dumber includes automatic hardware
296 **Required packages:**300 **Required packages:**
297 - Arch Linux:301 - Arch Linux:
298 - `sudo pacman -S gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav gst-plugin-pipewire pipewire pipewire-pulse`302 - `sudo pacman -S gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav gst-plugin-pipewire pipewire pipewire-pulse`
299- - Hardware accel: `gstreamer-vaapi mesa` (AMD), `libva-nvidia-driver` (NVIDIA), `libva-intel-driver intel-media-driver` (Intel)303+ - Hardware decoding: `gst-plugin-va` (stateless VA decoders - required for WebKitGTK)
304+ - VA-API drivers: `libva-mesa-driver mesa` (AMD), `libva-nvidia-driver` (NVIDIA), `libva-intel-driver intel-media-driver` (Intel)
300 - Debian/Ubuntu:305 - Debian/Ubuntu:
301 - `sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-pipewire`306 - `sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-pipewire`
302- - Hardware accel: `gstreamer1.0-vaapi va-driver-all` (covers most GPUs)307+ - Hardware decoding: `gstreamer1.0-plugins-bad` includes VA stateless decoders
308+ - VA-API drivers: `va-driver-all` (covers most GPUs)
303 309
304 ## Contribute310 ## Contribute
305 I will gladly accept contributions, especially related to UI/UX enhancements. Feel free to open an issue and let's discuss it!311 I will gladly accept contributions, especially related to UI/UX enhancements. Feel free to open an issue and let's discuss it!

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 8

Tags 42

↑↓ moveenter openesc close