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 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 and WebKit
83
84```bash
85sudo apt install libgtk-4-1 libwebkitgtk-6.0-4
86```
87
88### VA-API
89
90```bash
91sudo apt install libva2 vainfo
92```
93
94#### VA-API Drivers
95
96**Intel:**
97```bash
98sudo apt install intel-media-va-driver  # or i965-va-driver for older
99```
100
101**AMD:**
102```bash
103sudo apt install mesa-va-drivers
104```
105
106**NVIDIA:**
107Requires manual setup or third-party PPA.
108
109### Vulkan
110
111```bash
112sudo apt install libvulkan1 vulkan-tools
113```
114
115**Intel:**
116```bash
117sudo apt install mesa-vulkan-drivers
118```
119
120**AMD:**
121```bash
122sudo apt install mesa-vulkan-drivers
123```
124
125**NVIDIA:**
126```bash
127sudo apt install nvidia-vulkan-icd
128```
129
130### GStreamer
131
132```bash
133sudo apt install gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
134    gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav
135```
136
137## Verification Commands
138
139### Check VA-API
140
141```bash
142vainfo
143```
144
145### Check Vulkan
146
147```bash
148vulkaninfo | grep VK_KHR_video_
149```
150
151### Monitor GPU Decoder Usage
152
153```bash
154nvtop  # or intel_gpu_top for Intel
155```
156
157## Environment Variables
158
159If auto-detection fails, you can force a specific VA-API driver:
160
161```bash
162# Intel (newer)
163export LIBVA_DRIVER_NAME=iHD
164
165# Intel (older)
166export LIBVA_DRIVER_NAME=i965
167
168# AMD
169export LIBVA_DRIVER_NAME=radeonsi
170```