Guide de dépannage Linux
Linux dispose de deux protocoles de serveur d'affichage — Wayland et X11 — et chacun requiert des outils différents pour simuler la saisie clavier. Ce guide vous aidera à tout faire fonctionner.
La plupart des distributions récentes (Fedora 40+, Ubuntu 24.04+, GNOME 46+) utilisent Wayland par défaut. Les installations plus anciennes ou celles qui utilisent certains pilotes NVIDIA peuvent encore tourner sous X11.
Comment savoir si je suis sous Wayland ou X11 ?
Vérifiez votre serveur d'affichage
Ouvrez un terminal et exécutez cette commande :
Si la sortie est vide, vous êtes probablement sous X11. Certains gestionnaires d'affichage ne définissent pas cette variable.
Configuration Wayland
Pour Fedora, Ubuntu, Arch et les autres distributions récentes
Wayland a besoin de ydotool — un émulateur d'entrée indépendant du serveur d'affichage qui communique directement avec le noyau. Il nécessite un démon en arrière-plan et l'autorisation d'écrire dans /dev/uinput.
Fedora / Fedora Atomic
Installer ydotool
Pour Fedora standard :
Sur les variantes Fedora Atomic (Silverblue, Kinoite, Universal Blue), utilisez rpm-ostree install ydotool && systemctl reboot à la place.
Activer le démon
Démarrez ydotoold maintenant et configurez-le pour se lancer à chaque démarrage :
Ajouter votre utilisateur au groupe input
Autorisez votre utilisateur à utiliser le périphérique d'entrée virtuel :
Vous devez vous déconnecter puis vous reconnecter (ou redémarrer) pour que le changement de groupe prenne effet.
Vérifier que ça fonctionne
Vérifiez que ydotool peut simuler des frappes de touches :
Ubuntu / Debian
Installer ydotool
Activer le démon, rejoindre le groupe input et vérifier
Mêmes étapes que pour Fedora ci-dessus :
Arch Linux
Installer ydotool
Activer le démon, rejoindre le groupe input et vérifier
Mêmes étapes que pour Fedora ci-dessus :
Configuration X11
Pour les distributions plus anciennes ou traditionnellesX11 utilise xdotool, qui est plus simple — aucun démon nécessaire, et il fonctionne généralement tel quel.
Installer xdotool
Choisissez la commande correspondant à votre distribution :
C'est tout
xdotool fonctionne immédiatement après l'installation. Aucun démon ni changement de groupe nécessaire.
Saisie de texte sous Wayland
Si vous utilisez l'action Saisir du texte sous Wayland, MIDI Mapper a besoin de wtype pour saisir les caractères.
wtype n'est nécessaire que pour saisir du texte. La simulation des raccourcis clavier utilise ydotool.
Problèmes courants
« ydotool: command not found »
ydotool n'est pas installé. Suivez les étapes de configuration Wayland ci-dessus pour votre distribution.
Les touches sont envoyées mais rien ne se passe
Le démon ydotoold n'est probablement pas en cours d'exécution. Vérifiez son état et redémarrez-le :
« Permission denied » ou « Failed to open /dev/uinput »
Votre utilisateur ne fait pas partie du groupe input. Ajoutez-vous au groupe, puis déconnectez-vous et reconnectez-vous :
N'oubliez pas de vous déconnecter puis de vous reconnecter après avoir exécuté cette commande.
Les raccourcis clavier ne sont pas capturés dans l'application
Votre compositeur de bureau (GNOME, KDE, Cosmic) peut intercepter certains raccourcis avant qu'ils n'atteignent l'application. Vérifiez les réglages de raccourcis clavier de votre système et désactivez ceux qui entrent en conflit, ou saisissez la combinaison de touches manuellement dans le champ texte de MIDI Mapper au lieu d'utiliser le bouton de capture.
SELinux bloque ydotool (Fedora)
Sous Fedora, SELinux peut empêcher ydotool d'accéder à /dev/uinput. Recherchez les refus :
Si des refus apparaissent, créez une exception locale dans la politique SELinux. Il s'agit d'une étape avancée — consultez la documentation SELinux de Fedora pour plus de détails.
Tout est prêt !
Votre système Linux est configuré pour les raccourcis clavier et la saisie de texte de MIDI Mapper.