1# Dependencies
2
3This page lists the system dependencies required to run Dumber on different Linux distributions.
4
5## Arch Linux
6
7### Core GTK4, CEF, and WebKit fallback
8
9```bash
10sudo pacman -S gtk4 cef webkitgtk-6.0
11```
12
13### VA-API (Hardware Video Acceleration)
14
15```bash
16sudo pacman -S libva libva-utils
17```
18
19For CEF hardware video decoding, `cef-vaapi` is available from the AUR as an optional CEF build.
20
21#### VA-API Drivers (install one based on GPU)
22
23**Intel (Broadwell and newer):**
24```bash
25sudo pacman -S intel-media-driver
26```
27
28**Intel (older):**
29```bash
30sudo pacman -S libva-intel-driver
31```
32
33**AMD:**
34```bash
35sudo pacman -S libva-mesa-driver
36```
37
38**NVIDIA:**
39```bash
40sudo pacman -S libva-nvidia-driver  # or nvidia-vaapi-driver from AUR
41```
42
43### Vulkan
44
45```bash
46sudo pacman -S vulkan-icd-loader
47```
48
49**Intel:**
50```bash
51sudo pacman -S vulkan-intel
52```
53
54**AMD:**
55```bash
56sudo pacman -S vulkan-radeon
57```
58
59**NVIDIA:**
60```bash
61sudo pacman -S nvidia-utils  # includes Vulkan
62```
63
64### GStreamer Plugins (for WebKit fallback media playback)
65
66```bash
67sudo pacman -S gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav
68```
69
70### Verification Tools
71
72```bash
73sudo pacman -S vulkan-tools  # for vulkaninfo
74```
75
76### CEF Wayland rendering
77
78CEF is Dumber's default engine. It uses the GPU-first Wayland stack: GDK DMABUF presentation with ANGLE/GSK Vulkan. No launch wrapper or render environment variables are required for normal use. For driver compatibility, set `engine.cef.render_stack = "egl"` (or `DUMBER_ENGINE_CEF_RENDER_STACK=egl`) to use the GtkGLArea/EGL/OpenGL stack.
79
80## Debian/Ubuntu
81
82### Core GTK4, CEF, and WebKit fallback
83
84```bash
85sudo apt install libgtk-4-1 libwebkitgtk-6.0-4
86# Also provide a CEF runtime for the default backend (package name varies by distribution).
87```
88
89### VA-API
90
91```bash
92sudo apt install libva2 vainfo
93```
94
95#### VA-API Drivers
96
97**Intel:**
98```bash
99sudo apt install intel-media-va-driver  # or i965-va-driver for older
100```
101
102**AMD:**
103```bash
104sudo apt install mesa-va-drivers
105```
106
107**NVIDIA:**
108Requires manual setup or third-party PPA.
109
110### Vulkan
111
112```bash
113sudo apt install libvulkan1 vulkan-tools
114```
115
116**Intel:**
117```bash
118sudo apt install mesa-vulkan-drivers
119```
120
121**AMD:**
122```bash
123sudo apt install mesa-vulkan-drivers
124```
125
126**NVIDIA:**
127```bash
128sudo apt install nvidia-vulkan-icd
129```
130
131### GStreamer
132
133```bash
134sudo apt install gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
135    gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav
136```
137
138## Verification Commands
139
140### Check VA-API
141
142```bash
143vainfo
144```
145
146### Check Vulkan
147
148```bash
149vulkaninfo | grep VK_KHR_video_
150```
151
152### Monitor GPU Decoder Usage
153
154```bash
155nvtop  # or intel_gpu_top for Intel
156```
157
158## Environment Variables
159
160If auto-detection fails, you can force a specific VA-API driver:
161
162```bash
163# Intel (newer)
164export LIBVA_DRIVER_NAME=iHD
165
166# Intel (older)
167export LIBVA_DRIVER_NAME=i965
168
169# AMD
170export LIBVA_DRIVER_NAME=radeonsi
171```