Dennis HilkLinux Fix LabEN

Desktop, X11 und Wayland

Bildschirmfreigabe unter Wayland funktioniert nicht

Ein funktionierender Wayland-Desktop garantiert keine ScreenCast-Freigabe. Sitzung, Portal-Backend und PipeWire-Stream getrennt prüfen.

Redaktionelle Quellenprüfung: Mit den Hinweisen beginnenAnleitung teilen
Auf dieser Seite
  1. Symptome und Geltungsbereich
  2. Mögliche Ursachen
  3. Sicher prüfen
  4. Nächste Schritte nach Befund
  5. Quellen und Prüfung
  6. Verwandte Probleme

Symptome und Geltungsbereich

  • Eine Video- oder Streaming-App zeigt keinen Bildschirm oder nur Schwarz, obwohl Desktopfenster normal funktionieren.
  • Der Portal-Auswahldialog fehlt, lehnt ab oder liefert keinen Capture-Stream, obwohl das Mikrofon funktioniert.

Betroffene Umgebung

Wayland-Sitzungen mit KDE Plasma, GNOME oder wlroots-Compositor; Browser, Meetings und Flatpak-Apps können XDG Desktop Portal und PipeWire nutzen.

Mögliche Ursachen

Das sind mögliche Erklärungen, keine bestätigte Diagnose. Mehrere unabhängige Fehler können gleichzeitig vorliegen.

  • Das ausgewählte XDG-Portal-Backend bietet die ScreenCast-Schnittstelle möglicherweise nicht an oder passt nicht zur aktiven Sitzung.
  • Anwendung, Portal-Frontend, Compositor und PipeWire-Stream sind unabhängige Komponenten. Abgelehnte Freigabe oder fehlende PipeWire-Quelle beweisen keinen Grafiktreiberfehler.

Sicher prüfen

Führe jeweils einen Befehl in der passenden Sitzung aus. Lies zuerst die Erklärung. Großgeschriebene Platzhalter brauchen deine Werte; Werkzeuge und Rechte unterscheiden sich je nach Distribution. Die Website zeigt Befehle an und führt sie niemals aus.

Prüfschritt 1

Gemeldeten Sitzungstyp anzeigen; der Browser muss nicht denselben Capture-Pfad verwenden.

echo "$XDG_SESSION_TYPE"

Ergebnis einordnen: wayland beschreibt den Sitzungskontext, nicht die tatsächliche Verfügbarkeit des ScreenCast-Portals.

Prüfschritt 2

Desktopkennung anzeigen, die für die Portal-Backend-Auswahl verwendet wird.

echo "$XDG_CURRENT_DESKTOP"

Ergebnis einordnen: Eine unpassende Kennung kann ein Backend ohne benötigte Schnittstelle auswählen.

Prüfschritt 3

Status des Portal-Frontends in der Benutzersitzung lesen; Backends haben oft eigene Dienstnamen.

systemctl --user status xdg-desktop-portal.service

Ergebnis einordnen: Ein aktives Frontend belegt weder das passende ScreenCast-Backend noch einen funktionierenden PipeWire-Stream.

Nächste Schritte nach Befund

ScreenCast-Portal-Backend passend zur Sitzung prüfen

Portal-Backend-Auswahl und angebotene Schnittstellen des Desktops prüfen. Für KDE die zur Distribution passende KDE-Integration, für GNOME deren Backend und für wlroots eine unterstützte Implementierung verwenden. ScreenCast kann über eine eigene Portal-Konfiguration unabhängig vom Dateidialog ausgewählt werden. Vor Änderungen prüfen, ob der Backend-Typ die angefragte Quelle unterstützt.

Vorsicht: Nicht wahllos alle Portal-Backends gleichzeitig aktivieren; konkurrierende Standards erschweren die Diagnose.

Wiederherstellung / Rücknahme: Gesicherte Portal-Konfiguration und Desktop-Sitzungswerte zurückstellen, falls ein Vergleich keine Besserung bringt.

Hat dir dieser Hinweis geholfen?

Hinweis teilen#

Quellen und Prüfung

Diese Anleitung basiert auf Originalquellen von Projekten oder Distributionen und wurde am genannten Datum redaktionell geprüft. Das ist eine Quellenprüfung, kein Nachweis einer auf deiner Hardware reproduzierten Lösung. Log-Beispiele sind synthetische Testdaten. Versionsabhängige Details müssen zur installierten Ausgabe passen.