---
title: "qutebrowser Installation (Wayland / Sway)"
date: "2026-09-08"
---

# qutebrowser Installation (Wayland / Sway)

Tastaturgesteuerter, vim-artiger Browser auf Basis von Python + QtWebEngine
(Chromium/Blink-Engine). Kein Fork, sondern eigenständig.

Hinweis: qutebrowser liegt im offiziellen Repo (`extra`), nicht im AUR.

---

## 1. Basis-Installation

```bash
sudo pacman -S qutebrowser
```

---

## 2. Video-Hardwarebeschleunigung (VAAPI)

Deine GPU: Intel Iris Xe (TigerLake). Dafür brauchst du den Intel-Media-Driver
und die VAAPI-Utils zum Prüfen:

```bash
sudo pacman -S intel-media-driver libva-utils
```

Testen ob VAAPI läuft:

```bash
vainfo
```

Erwartete Ausgabe: eine Liste mit Profilen (H264, HEVC/VP9-Decoding etc.).
Falls leer oder Fehler -> Treiberproblem.

In qutebrowser aktivieren (`:set` oder in `~/.config/qutebrowser/config.py`):

```
qt.args:
  - ignore-gpu-blocklist
  - enable-features=VaapiVideoDecoder,VaapiVideoDecodeLinuxGL
  - enable-accelerated-video-decode
```

---

## 3. DRM / Widevine (Netflix, Prime, Spotify …)

Widevine ist proprietär und nicht im offiziellen Repo. Das AUR-Paket
`chromium-widevine` stellt das Widevine-CDM (`libwidevinecdm.so`) bereit:

```bash
yay -S chromium-widevine
```

Das Paket legt die Bibliothek ab unter:

```
/usr/lib/chromium/libwidevinecdm.so
```

Pfad in qutebrowser bekannt machen (in `config.py`):

```python
c.qt.args = [
    "widevine-path=/usr/lib/chromium/libwidevinecdm.so",
    "ignore-gpu-blocklist",
    "enable-features=VaapiVideoDecoder",
]
```

Danach qutebrowser neu starten und prüfen:

```
:version
```

Dort sollte Widevine aufgelistet sein. Prüfseite: https://bitmovin.com/demos/drm

Wichtige Einschränkung: Widevine unter Linux liefert maximal **1080p** (L3-Lizenz).
4K-Streaming geht auf Linux nur mit Microsoft Edge oder Safari/macOS.

---

## 4. Wayland-nativ starten

Sway ist Wayland, also qutebrowser nativ (ohne XWayland) laufen lassen:

```
:set qt.args
```

oder in `config.py`:

```python
c.qt.args = ["widevine-path=..."]
```

Standardmäßig nutzt qutebrowser unter Sway bereits Wayland. Prüfen:

```
:version
```

Unter "Qt" sollte `wayland` als Platform stehen (nicht `xcb`).

---

## 5. Adblock & Datenschutz

qutebrowser hat einen eingebauten Host-Datei-Adblocker. Listen aktualisieren:

```
:adblock-update
```

Für besseren Schutz in `config.py`:

```python
# Standard-User-Agent abschalten (weniger Fingerprinting)
c.content.headers.user_agent = None

# DNT / Tracking-Opt-out
c.content.headers.do_not_track = True
```

---

## 6. Minimale Beispiel-Konfiguration

Datei: `~/.config/qutebrowser/config.py`

```python
import os

# DRM + Video-Hardwarebeschleunigung
c.qt.args = [
    "widevine-path=/usr/lib/chromium/libwidevinecdm.so",
    "ignore-gpu-blocklist",
    "enable-features=VaapiVideoDecoder,VaapiVideoDecodeLinuxGL",
]

# Startseite
c.url.start_pages = ["https://duckduckgo.com"]

# Adblock-Listen
c.content.blocking.enabled = True
c.content.blocking.method = "both"          # hosts + adblock
c.content.blocking.hosts.lists = [
    "https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts",
]

# Tabs / Verhalten
c.tabs.position = "top"
c.confirm_quit = ["downloads"]

# Tastatur: h/j/k/l Navigation (bereits Standard bei qutebrowser)
```

---

## 7. Wichtigste Tastenkürzel

| Taste | Aktion |
|---|---|
| `:` | Befehlszeile |
| `o` | URL öffnen |
| `O` | URL in neuem Tab öffnen |
| `f` | Links per Buchstabenkürzel anklicken |
| `H` / `L` | Zurück / Vor |
| `j` / `k` | Nach unten / oben scrollen |
| `gg` / `G` | Seitenanfang / -ende |
| `J` / `K` | Nächster / vorheriger Tab |
| `d` / `u` | Tab schließen / wieder öffnen |
| `/` | Suche auf Seite |
| `n` / `N` | Nächstes / vorheriges Suchergebnis |
| `yy` | URL in Zwischenablage |
| `ZZ` | qutebrowser beenden |

---

## 8. Alternativen im Überblick (schnell & sicher auf Sway)

| Browser | Engine | Install | Anmerkung |
|---|---|---|---|
| qutebrowser | Blink (Qt) | `sudo pacman -S qutebrowser` | Tastatur-only, ideal für Tiling |
| LibreWolf | Gecko (Firefox) | `yay -S librewolf-bin` | Firefox ohne Telemetrie, +uBlock |
| ungoogled-chromium | Blink | `yay -S ungoogled-chromium-bin` | Chromium ohne Google |
| Brave | Blink | `yay -S brave-bin` | Built-in Werbeblocker |

Für 4K-Streaming + Extensions: Brave. Für maximalen Datenschutz: LibreWolf.
Für reine Tastatur-Steuerung im Tiling-WM: qutebrowser.