Résolution du problème de dysfonctionnement des gestes du pavé tactile sous Wayland dans Ubuntu 24.04

Vous déplacez le pointeur normalement, le défilement à deux doigts fonctionne peut-être encore, mais le balayage à trois doigts habituel n'ouvre plus les Activités ni ne change d'espace de travail. Sous Ubuntu 24.04, ce problème est souvent diagnostiqué à tort comme une « désactivation des gestes Wayland ». Dans l'environnement de bureau GNOME standard, il n'existe pas d'option principale pour désactiver les gestes système à trois doigts intégrés. La question pertinente est de savoir où le geste s'arrête : au niveau de la session, des paramètres du pavé tactile, de libinput, de GNOME Shell ou du matériel lui-même ?

Ce guide commence par des vérifications rapides et réversibles, puis aborde le diagnostic des entrées. Ubuntu 24.04 LTS utilise GNOME sur Wayland par défaut sur les systèmes compatibles, et GNOME documente les balayages à trois doigts pour ouvrir la vue d'ensemble des activités et changer d'espace de travail. La pile libinput sous-jacente peut signaler les événements de balayage et de pincement sur les pavés tactiles compatibles. Ces deux éléments nous permettent de suivre une procédure de dépannage simple : vérifier l'utilisation de Wayland, vérifier que le pavé tactile est actif, tester le geste GNOME par défaut, puis vérifier si libinput reçoit les événements multi-doigts.

1. Vérifiez que vous êtes bien dans une session Wayland.

Ouvrez le Terminal et exécutez :

echo $XDG_SESSION_TYPE

Le résultat attendu est «wayland . ». Si la commande affiche «x11 , », vous dépannez un autre chemin d'entrée. Ubuntu peut toujours proposer une session Xorg, et le comportement des gestes y est différent de celui de GNOME Wayland.

Si vous utilisez Xorg et souhaitez la session Wayland par défaut, déconnectez-vous. Sur l'écran de connexion, sélectionnez votre compte, ouvrez le sélecteur de session et choisissez Ubuntu plutôt qu'Ubuntu sur Xorg lorsque ces options sont disponibles. Le matériel, les pilotes graphiques, les sessions de bureau à distance ou la politique d'administration peuvent influencer les sessions proposées ; n'essayez donc pas de forcer une option indisponible sans en comprendre la raison.

Le comportement officiel des gestes de GNOME est documenté dans l'aide de GNOME : Utiliser les gestes sur les pavés tactiles et les écrans tactiles .

2. Assurez-vous que le pavé tactile est activé.

Ouvrez Paramètres > Souris et pavé tactile . Vérifiez que le pavé tactile est activé. Testez également le défilement à deux doigts et les clics simples. Le panneau de configuration de GNOME n'affiche les commandes du pavé tactile que si le bureau le reconnaît ; l'absence de la section « Pavé tactile » est donc un indice important et non un simple problème d'affichage.

Ne perdez pas de temps à chercher une option « gestatifs à trois doigts » dans les paramètres d'Ubuntu 24.04. Les gestes système intégrés à GNOME Shell ne sont généralement pas contrôlés par un interrupteur dédié. Si le déplacement du pointeur et le défilement à deux doigts fonctionnent, mais pas les gestes à trois doigts, passez au test suivant.

Pour connaître les commandes du pavé tactile documentées, consultez l'aide de GNOME : Cliquer, faire glisser ou faire défiler avec le pavé tactile .

3. Testez un geste GNOME standard, et non un geste spécifique à une application.

Utilisez trois doigts et faites glisser votre doigt vers le haut sur le pavé tactile. GNOME devrait ouvrir la vue d'ensemble des activités. Un glissement supplémentaire vers le haut permet d'ouvrir la vue des applications. Un glissement à trois doigts vers la gauche ou la droite permet de changer d'espace de travail. Ces tests constituent la meilleure référence car il s'agit de gestes de GNOME Shell, et non de fonctionnalités fournies par Firefox, une extension de navigateur, un module complémentaire ou un service tiers de gestion des gestes.

Le zoom par pincement est différent. libinput reconnaît les gestes de pincement, mais le zoom dépend de l'application et de la boîte à outils. Un balayage à trois doigts fonctionnel dans l'espace de travail, associé à un pincement inopérant dans une même application, indique généralement un problème avec l'application elle-même, et non avec Wayland dans son ensemble.

4. Vérifiez si libinput reconnaît le pavé tactile

Ubuntu fournit le libinput-toolspaquet pour les diagnostics d'entrée. Si la libinputcommande n'est pas installée, ajoutez-la avec :

sudo apt update
sudo apt install libinput-tools

Ensuite, listez les appareils :

sudo libinput list-devices

Trouvez le bloc correspondant à votre pavé tactile. Le nom exact du modèle, le nœud d'événement, les dimensions et la configuration varient selon l'ordinateur portable. L'important est que libinput reconnaisse le périphérique comme un pavé tactile et expose les fonctionnalités attendues. Le paquet Ubuntu 24.04 est documenté dans le catalogue de paquets Ubuntu Noble , et la commande elle-même est décrite dans la page de manuel de libinput d'Ubuntu .

Si le pavé tactile est absent libinput list-devices, il ne s'agit plus principalement d'un problème lié aux gestes GNOME. Vérifiez si le périphérique apparaît dans les paramètres du firmware/BIOS, si l'option de basculement matériel du pavé tactile est activée et si le noyau le détecte après un redémarrage. Les problèmes spécifiques au noyau, à l'interface I2C-HID ou au firmware de votre ordinateur portable doivent être résolus pour que GNOME puisse recevoir les gestes.

5. Observez les événements gestuels bruts

Le test le plus instructif consiste à vérifier si libinput émet des événements gestuels lorsque vous déplacez trois doigts. Exécutez :

sudo libinput debug-events

Effectuez ensuite un balayage à trois doigts. Sur le matériel compatible, vous devriez voir des lignes d'événements gestuels indiquant le début, les mises à jour et la fin du balayage. Le nœud d'événement exact, le timing, les deltas et le formatage peuvent varier. Cette commande nécessite généralement un accès root car elle lit /dev/input/event*directement les périphériques.

La page de manuel officielle d'Ubuntu pour libinput-debug-events décrit cet outil comme une aide au débogage et prévient que son format de sortie peut changer. La documentation de libinput sur les gestes explique comment les gestes de balayage et de pincement sont générés.

Si les gestes sont détectés : le matériel et le chemin d’accès à libinput sont fonctionnels. Vérifiez ensuite GNOME Shell, les extensions, l’état de la session et les mises à jour. Si aucun geste multi-doigts n’est détecté : effectuez un nouveau test en écartant clairement les doigts. Si les gestes de base du pointeur sont détectés mais pas les gestes à trois doigts, le pavé tactile peut ne pas prendre en charge le multitouch, ou un problème de noyau/micrologiciel peut l’empêcher de signaler suffisamment de contacts.

6. Installez les mises à jour actuelles d'Ubuntu 24.04

Avant de remplacer des pilotes ou de modifier des fichiers de configuration de bas niveau, mettez à jour les paquets 24.04 installés :

sudo apt update
sudo apt upgrade

Redémarrez si la mise à jour installe un nouveau noyau, une nouvelle pile graphique ou d'autres composants nécessitant un redémarrage. La gestion des gestes s'effectue sur plusieurs couches (pilotes d'entrée du noyau, libinput, Mutter/GNOME Shell et applications) ; un bogue déjà corrigé peut donc rester visible sur une machine non mise à jour.

Évitez de télécharger des paquets Synaptics aléatoires ou de copier d'anciens extraits de configuration Xorg provenant de tutoriels rédigés pour des versions antérieures d'Ubuntu. Sous une session GNOME Wayland standard, libinput est la bibliothèque d'entrée appropriée, et les fichiers de configuration Xorg seuls ne constituent pas une méthode fiable pour réparer les gestes de GNOME Shell.

7. Désactiver temporairement les extensions GNOME Shell

Si libinput debug-eventsl'écran affiche clairement les balayages à trois doigts mais que GNOME ne réagit pas, désactivez temporairement les extensions tierces de GNOME Shell et réessayez. Les extensions peuvent modifier le comportement de l'espace de travail, la gestion des fenêtres, l'affichage de la vue d'ensemble ou la gestion des gestes. Utilisez l'application Extensions si elle est installée, ou listez les extensions activées avec :

gnome-extensions list --enabled

Désactivez les extensions suspectes une par une avec :

gnome-extensions disable EXTENSION_UUID

Remplacez EXTENSION_UUIDpar un identifiant renvoyé par la commande list. Se déconnecter puis se reconnecter après avoir modifié les extensions Shell permet de s'assurer que vous testez une session propre.

Cette étape est un diagnostic et ne constitue pas une recommandation pour une utilisation permanente sans extensions. Une fois l'extension conflictuelle identifiée, mettez-la à jour, ajustez ses paramètres ou désactivez-la.

8. Ouvrez une nouvelle session Wayland et effectuez un nouveau test.

Déconnectez-vous, choisissez la session Ubuntu Wayland normale lors de la connexion, puis répétez les tests de gestes par défaut avant de rouvrir de nombreuses applications. Cela efface l'état temporaire de GNOME Shell et permet de déterminer plus facilement si une extension ou un processus spécifique à la session était impliqué.

Si le système revient systématiquement à Xorg même lorsque vous sélectionnez Ubuntu, recherchez la cause du problème plutôt que de supposer que le pavé tactile est en cause. La compatibilité des pilotes graphiques, la configuration de l'accès à distance ou la politique locale peuvent influencer la session disponible.

Pourquoi l'installation de Touchegg n'est généralement pas la première solution à envisager sous Wayland

Il est souvent conseillé d'installer immédiatement un gestionnaire de gestes. Cela peut s'avérer utile pour les actions personnalisées dans certains environnements, mais ce n'est pas la solution idéale lorsque les gestes GNOME intégrés ne fonctionnent pas dans une session Wayland. GNOME Shell implémente déjà ses propres gestes système à trois doigts. Ajouter une couche de gestes supplémentaire avant de vérifier ce que libinput reconnaît peut compliquer le diagnostic et engendrer des conflits avec les gestes système.

Les recommandations d'interface utilisateur de GNOME précisent que les gestes à trois et quatre doigts sont réservés à l'usage du système. C'est pourquoi le comportement des gestes au niveau de l'application n'est pas interchangeable avec celui des gestes de l'espace de travail du bureau. Consultez les recommandations de GNOME concernant le pointeur et l'interaction tactile .

Comment vérifier que le problème est réellement résolu ?

Ne vous arrêtez pas au simple constat que « le curseur bouge ». Une réparation réussie doit passer plusieurs contrôles indépendants :

• echo $XDG_SESSION_TYPEretours wayland.
• La section Pavé tactile est présente dans les Paramètres et le fonctionnement normal du pavé tactile est opérationnel.
• Un glissement de trois doigts vers le haut ouvre la section Activités.
• Un glissement de trois doigts vers la gauche ou la droite permet de changer d'espace de travail.
• sudo libinput debug-eventsaffiche les événements gestuels multi-doigts correspondants.
• Les gestes restent fonctionnels après une déconnexion ou un redémarrage.

Si le test libinput réussit mais que les gestes GNOME ne fonctionnent toujours pas après les mises à jour, les tests d'extensions et une nouvelle connexion Wayland, le problème se situe au niveau de la session de bureau ou du compositeur. Dans ce cas, veuillez indiquer la version d'Ubuntu, la version du noyau uname -r, la version de GNOME Shell gnome-shell --version, le modèle de pavé tactile libinput list-deviceset une brève description du geste par défaut qui ne fonctionne pas. Ces informations seront bien plus utiles pour un rapport de bogue que de réinstaller les pilotes sans discernement.

Si libinput ne détecte jamais les gestes à trois doigts, vérifiez les capacités matérielles, le firmware et la prise en charge par le noyau. Si les gestes de pincement ou de navigation d'une seule application échouent alors que ceux de l'espace de travail GNOME fonctionnent, effectuez un dépannage séparé pour cette application. Cette distinction est essentielle pour résoudre les problèmes de gestes du pavé tactile sous Ubuntu 24.04 sans transformer un petit problème de saisie en un problème de configuration système plus important.