Behebung des Problems, dass Touchpad-Gesten unter Wayland in Ubuntu 24.04 nicht funktionieren

Sie bewegen den Mauszeiger normal, das Scrollen mit zwei Fingern funktioniert möglicherweise noch, aber die gewohnte Drei-Finger-Geste öffnet weder Aktivitäten noch wechselt sie zwischen Arbeitsbereichen. Unter Ubuntu 24.04 wird dieses Symptom oft fälschlicherweise als „Wayland-Gesten deaktiviert“ diagnostiziert. Im Standard-GNOME-Desktop gibt es keinen separaten Hauptschalter für die integrierten Drei-Finger-Systemgesten. Die entscheidende Frage ist, wo die Geste nicht mehr funktioniert: in der Sitzung, in den Touchpad-Einstellungen, in libinput, in der GNOME Shell oder in der Hardware selbst.

Dieser Leitfaden beginnt mit schnellen und reversiblen Prüfungen und geht dann auf die Eingabediagnose ein. Ubuntu 24.04 LTS verwendet standardmäßig GNOME unter Wayland auf unterstützten Systemen. GNOME dokumentiert Drei-Finger-Gesten zum Öffnen der Aktivitätenübersicht und zum Wechseln von Arbeitsbereichen. Der zugrunde liegende libinput-Stack kann Wisch- und Pinch-Gesten auf unterstützten Touchpads erkennen. Diese beiden Tatsachen ermöglichen eine einfache Fehlersuche: Wayland bestätigen, Touchpad aktivieren, GNOME-Standardgeste testen und anschließend prüfen, ob libinput Mehrfingergesten empfängt.

1. Vergewissern Sie sich, dass Sie sich tatsächlich in einer Wayland-Sitzung befinden.

Terminal öffnen und folgenden Befehl ausführen:

echo $XDG_SESSION_TYPE

Das erwartete Ergebnis ist wayland. Falls der Befehl ausgibt x11, liegt das Problem an einem anderen Eingabepfad. Ubuntu kann weiterhin eine Xorg-Sitzung anbieten, deren Gestensteuerung jedoch nicht mit der nativen GNOME-Wayland-Umgebung identisch ist.

Wenn Sie Xorg verwenden und die standardmäßige Wayland-Sitzung nutzen möchten, melden Sie sich ab. Wählen Sie auf dem Anmeldebildschirm Ihr Konto aus, öffnen Sie die Sitzungsauswahl und wählen Sie, falls verfügbar, „Ubuntu“ anstelle von „Ubuntu auf Xorg“ . Hardware, Grafiktreiber, Remote-Desktop-Sitzungen oder Administratorrichtlinien können die verfügbaren Sitzungen beeinflussen. Versuchen Sie daher nicht, eine fehlende Option zu erzwingen, ohne vorher die Ursache zu prüfen.

Das offizielle Gestenverhalten von GNOME ist in der GNOME-Hilfe dokumentiert: Gesten auf Touchpads und Touchscreens verwenden .

2. Stellen Sie sicher, dass das Touchpad selbst aktiviert ist.

Öffnen Sie Einstellungen > Maus & Touchpad . Stellen Sie sicher, dass das Touchpad aktiviert ist. Testen Sie außerdem das Scrollen mit zwei Fingern und einfaches Tippen. Die Touchpad-Steuerung wird in den GNOME-Einstellungen nur angezeigt, wenn der Desktop ein Touchpad erkennt. Ein fehlender Touchpad-Bereich ist daher ein wichtiger Hinweis und kein rein kosmetischer Fehler.

Suchen Sie nicht in den Standardeinstellungen von Ubuntu 24.04 nach einer Option für Drei-Finger-Gesten. Die in GNOME Shell integrierten Systemgesten lassen sich dort normalerweise nicht über einen separaten Schalter steuern. Falls Mauszeigerbewegung und Zwei-Finger-Scrollen funktionieren, Drei-Finger-Gesten jedoch nicht, fahren Sie mit dem nächsten Test fort.

Die dokumentierten Touchpad-Steuerelemente finden Sie in der GNOME-Hilfe: Klicken, ziehen oder scrollen mit dem Touchpad .

3. Testen Sie eine Standardgeste von GNOME, keine app-spezifische Geste.

Wischen Sie mit drei Fingern auf dem Touchpad nach oben. GNOME sollte die Aktivitätenübersicht öffnen. Ein weiteres Wischen nach oben öffnet die Anwendungsansicht. Mit einem Wisch mit drei Fingern nach links oder rechts wechseln Sie zwischen den Arbeitsbereichen. Diese Gesten eignen sich am besten als Vergleichsgrundlage, da sie in der GNOME Shell integriert sind und nicht von Firefox, Browsererweiterungen, Desktop-Add-ons oder Drittanbieter-Gestendiensten stammen.

Das Zoomen mit zwei Fingern funktioniert anders. libinput erkennt zwar Pinch-Gesten, ob diese jedoch Inhalte vergrößern oder verkleinern, hängt von der jeweiligen Anwendung und dem verwendeten Toolkit ab. Wenn eine Wischgeste mit drei Fingern im Arbeitsbereich funktioniert, während eine Pinch-Geste in einer Anwendung nicht funktioniert, liegt das Problem in der Regel an der Anwendung selbst und nicht an Wayland als Ganzes.

4. Überprüfen Sie, ob libinput das Touchpad erkennt.

Ubuntu stellt das libinput-toolsPaket für die Eingabediagnose bereit. Falls der libinputBefehl nicht installiert ist, fügen Sie ihn mit folgendem Befehl hinzu:

sudo apt update
sudo apt install libinput-tools

Dann die Geräte auflisten:

sudo libinput list-devices

Suchen Sie den Block für Ihr Touchpad. Modellname, Ereignisknoten, Abmessungen und Konfiguration variieren je nach Laptop. Wichtig ist, dass libinput das Gerät als Touchpad erkennt und die erwarteten Funktionen bereitstellt. Das Ubuntu-24.04-Paket ist im Ubuntu-Noble-Paketkatalog dokumentiert , und der Befehl selbst wird in der Manpage zu libinput beschrieben .

Wenn das Touchpad nicht angezeigt wird libinput list-devices, liegt das Problem nicht mehr primär an den GNOME-Gesten. Prüfen Sie, ob das Gerät in den Firmware-/BIOS-Einstellungen erscheint, ob die Option zum Aktivieren des Hardware-Touchpads aktiviert ist und ob der Kernel das Gerät nach einem Neustart erkennt. Laptop-spezifische Kernel-, I2C-HID- oder Firmware-Probleme müssen behoben werden, bevor GNOME Gesten verarbeiten kann.

5. Sehen Sie sich die Rohdaten der Gestenereignisse an.

Der aussagekräftigste Test besteht darin zu prüfen, ob libinput Gestenereignisse ausgibt, während Sie drei Finger bewegen. Ausführen:

sudo libinput debug-events

Führen Sie anschließend eine Wischgeste mit drei Fingern aus. Auf unterstützter Hardware sollten Sie Ereigniszeilen für Gesten wie Wischbeginn, Aktualisierungen und Ende sehen. Der genaue Ereignisknoten, das Timing, die Änderungen und das Format können variieren. Der Befehl benötigt in der Regel Root-Zugriff, da er /dev/input/event*Geräte direkt ausliest.

Die offizielle Manpage von Ubuntu libinput-debug-events beschreibt dieses Tool als Debugging-Hilfsprogramm und weist darauf hin, dass sich das Ausgabeformat ändern kann. Die Gestendokumentation von libinput erklärt, wie Wisch- und Pinch-Gesten generiert werden.

Wenn Gestenereignisse auftreten: Hardware und libinput funktionieren. Überprüfen Sie als Nächstes GNOME Shell, Erweiterungen, Sitzungsstatus und Updates. Falls keine Mehrfingergesten auftreten: Testen Sie erneut mit deutlich gespreizten Fingern. Wenn einfache Zeigerereignisse auftreten, Dreifingergesten jedoch nicht, fehlt dem Touchpad möglicherweise die erforderliche Multitouch-Funktionalität, oder ein Kernel-/Firmware-Problem verhindert, dass genügend Kontakte erkannt werden.

6. Installieren Sie die aktuellen Ubuntu 24.04-Updates.

Bevor Sie Treiber ersetzen oder Low-Level-Konfigurationsdateien bearbeiten, aktualisieren Sie die installierten 24.04-Pakete:

sudo apt update
sudo apt upgrade

Starten Sie den Computer neu, falls das Update einen neuen Kernel, Grafikstack oder andere Komponenten installiert, die einen Neustart erfordern. Die Gestenverarbeitung durchläuft mehrere Ebenen – Kernel-Eingabetreiber, libinput, Mutter/GNOME Shell und Anwendungen –, sodass ein bereits behobener Fehler auf einem nicht aktualisierten System weiterhin sichtbar sein kann.

Vermeiden Sie es, beliebige Synaptics-Pakete herunterzuladen oder alte Xorg-Konfigurationsfragmente aus Anleitungen für frühere Ubuntu-Versionen zu kopieren. In der Standard-GNOME-Sitzung unter Wayland ist libinput die relevante Eingabebibliothek, und reine Xorg-Konfigurationsdateien sind keine zuverlässige Methode, um GNOME-Shell-Gesten zu reparieren.

7. GNOME Shell-Erweiterungen vorübergehend deaktivieren.

Wenn libinput debug-eventsdie Drei-Finger-Geste zwar angezeigt wird, GNOME aber nicht reagiert, deaktivieren Sie vorübergehend alle GNOME Shell-Erweiterungen von Drittanbietern und testen Sie erneut. Erweiterungen können das Verhalten des Arbeitsbereichs, die Fensterverwaltung, die Übersicht oder die Gestensteuerung beeinflussen. Verwenden Sie die Erweiterungs-App, falls installiert, oder listen Sie die aktivierten Erweiterungen mit folgendem Befehl auf:

gnome-extensions list --enabled

Verdächtige Erweiterungen können Sie nacheinander deaktivieren:

gnome-extensions disable EXTENSION_UUID

Ersetzen Sie dies EXTENSION_UUIDdurch eine Kennung, die vom Befehl `list` zurückgegeben wird. Das Ab- und erneute Anmelden nach dem Ändern von Shell-Erweiterungen kann dazu beitragen, dass Sie eine saubere Sitzung testen.

Dieser Schritt dient der Diagnose und ist keine Empfehlung, dauerhaft ohne Erweiterungen zu arbeiten. Sobald Sie die in Konflikt stehende Erweiterung identifiziert haben, aktualisieren Sie diese, passen Sie ihre Einstellungen an oder deaktivieren Sie nur diese Erweiterung.

8. Starten Sie eine neue Wayland-Sitzung und testen Sie erneut.

Melden Sie sich ab, wählen Sie beim Anmelden die normale Ubuntu-Wayland-Sitzung und wiederholen Sie die Standard-Gestentests, bevor Sie viele Anwendungen erneut öffnen. Dadurch wird der temporäre Zustand der GNOME Shell gelöscht und es lässt sich leichter feststellen, ob eine Erweiterung oder ein sitzungsspezifischer Prozess beteiligt war.

Wenn das System trotz Auswahl von Ubuntu immer wieder zu Xorg zurückkehrt, sollten Sie die Ursache untersuchen, anstatt von einem Defekt des Touchpads auszugehen. Grafiktreiberkompatibilität, Fernzugriffskonfiguration oder lokale Richtlinien können die verfügbare Sitzung beeinflussen.

Warum die Installation von Touchegg unter Wayland normalerweise nicht die erste Lösung ist

Häufig wird empfohlen, sofort einen Gesten-Daemon zu installieren. Dies kann in manchen Umgebungen für benutzerdefinierte Aktionen nützlich sein, ist aber nicht die richtige erste Reaktion, wenn die integrierten GNOME-Gesten in einer Wayland-Sitzung nicht funktionieren. Die GNOME Shell implementiert bereits eigene Drei-Finger-Systemgesten. Das Hinzufügen einer weiteren Gestenebene, bevor man überprüft hat, was libinput erkennt, kann die Diagnose erschweren und Konflikte mit systemreservierten Gesten verursachen.

Die GNOME-Richtlinien für die Benutzeroberfläche weisen darauf hin, dass Drei- und Vier-Finger-Gesten der Systemnutzung vorbehalten sind. Daher ist das Gestenverhalten von Anwendungen nicht mit den Gesten der Desktop-Arbeitsumgebung austauschbar. Siehe die GNOME-Richtlinien für Mauszeiger und Touch .

Wie man überprüft, ob das Problem tatsächlich behoben wurde

Geben Sie sich nicht mit dem Punkt zufrieden, an dem sich der Cursor bewegt. Eine erfolgreiche Reparatur muss mehrere unabhängige Prüfungen bestehen:

• echo $XDG_SESSION_TYPERückgabewerte wayland.
• Der Touchpad-Bereich ist in den Einstellungen vorhanden und das normale Touchpad-Verhalten ist gegeben.
• Durch eine Wischgeste mit drei Fingern nach oben werden die Aktivitäten geöffnet.
• Durch eine Wischgeste mit drei Fingern nach links oder rechts kann zwischen den Arbeitsbereichen gewechselt werden.
• sudo libinput debug-eventszeigt entsprechende Mehrfingergesten an.
• Die Gesten funktionieren auch nach dem Ausloggen oder Neustart noch.

Wenn der libinput-Test erfolgreich ist, GNOME-Gesten aber nach Updates, Erweiterungstests und einer Neuanmeldung unter Wayland weiterhin nicht funktionieren, liegt das Problem wahrscheinlich an der Desktop-Sitzung oder dem Compositor. Notieren Sie sich in diesem Fall die Ubuntu-Version, die Kernel-Version uname -r, die GNOME-Shell-Version gnome-shell --version, das Touchpad-Modell libinput list-devicesund eine kurze Beschreibung der nicht funktionierenden Standardgeste. Diese Informationen sind für einen Fehlerbericht wesentlich hilfreicher als die bloße Neuinstallation von Treibern.

Wenn libinput keine Drei-Finger-Gesten erkennt, sollten Sie die Hardware, die Firmware und die Kernel-Unterstützung überprüfen. Falls nur bei einer Anwendung die Pinch- oder Navigationsgesten nicht funktionieren, während die Gesten im GNOME-Arbeitsbereich funktionieren, beheben Sie das Problem bei dieser Anwendung separat. Diese Unterscheidung ist entscheidend, um Touchpad-Gesten unter Ubuntu 24.04 zu reparieren, ohne ein kleines Eingabeproblem zu einem größeren Systemproblem auswachsen zu lassen.