The New Wayland Global Shortcuts Protocol
Un nouveau protocole Wayland pour les raccourcis globaux (XXHotKeyV1) est proposé en contournement du portail officiel Global Shortcuts Portal, suscitant un débat sur la gouvernance du développement Wayland entre approche descendante (top-down) et ascendante (bottom-up).

SYNTHÈSE STRUCTURÉE
Le problème des raccourcis globaux sur Wayland
Les raccourcis globaux (comme le push-to-talk de Discord pendant un jeu) ne fonctionnent pas nativement sur Wayland. L’intervenant explique : « Right now on Wayland, doesn’t work. Well, there are workarounds to get it to work on things like KDE, but it doesn’t work consistently because the KDE solution is basically a hack. » Le problème est connu depuis longtemps, et des solutions existent mais peinent à être adoptées.
Le portail Global Shortcuts Portal comme solution officielle
Le portail XDG Global Shortcuts Portal a été fusionné il y a longtemps et est implémenté par la plupart des environnements de bureau (KDE, GNOME, etc.). Il permet de définir des raccourcis globaux via l’interface du bureau. L’intervenant précise : « There is now a solution in place to support Global Shortcuts on Wayland. » Cependant, son adoption par les applications reste lente.
Les limites du portail pour les développeurs d’applications
Le portail impose une UX inversée par rapport aux autres plateformes : l’utilisateur doit configurer les raccourcis dans les paramètres du bureau, pas dans l’application. L’intervenant souligne : « The portal is a UX nightmare for any application developer, because what it forces you to do is not configure the shortcuts in the application configuration method, but instead configure them in whatever method is provided by the desktop. » Cela pose problème pour des applications comme OBS qui ont leur propre système de configuration.
Le protocole XXHotKeyV1 comme alternative
Le nouveau protocole XXHotKeyV1 permet à une application de choisir et reconfigurer librement ses propres raccourcis globaux, avec un retour explicite du compositeur (accepté/refusé avec raison). L’intervenant cite la description : « This protocol lets a client choose and freely reconfigure its own global hotkeys. It requires a specific key combination, and the compositor accepts it or denies it with a reason. » L’application garde le contrôle total de ses bindings.
L’argument technique contre le portail
Le protocole XXHotKeyV1 résout plusieurs limitations techniques du portail : impossibilité de transporter un serial d’entrée Wayland via D-Bus (nécessaire pour l’activation de fenêtres), dépendance à D-Bus que certains compositeurs n’ont pas, et absence de retour d’état pour l’application. L’intervenant explique : « A dbus signal can’t carry a Wayland input serial, so portal activation can’t produce a valid activation token. »
La stratégie d’implémentation bottom-up
Le développeur du protocole a choisi de l’implémenter d’abord dans des compositeurs (Hyprland, Niri) et des applications (Ghostty, OBS) avant de le proposer à Wayland upstream. L’intervenant note : « Rather than going through Upstream Wayland, rather than trying to iron out that issue and, like, deal with all the problems that come with doing that, instead, go to the compositors, go to the clients, and deal with them first. » C’est une approche inverse de la méthode officielle.
L’opposition d’OBS et la réouverture du débat
Un mainteneur d’OBS (MrTitan652) a fermé la PR en arguant que le protocole ne dépasserait jamais quelques gestionnaires de fenêtres. Mais un autre contributeur (Joel Bethke) l’a rouverte en déclarant : « I’m opting to reopen this for further comment and discussion. As for my eyesit, there hasn’t been any meaningful movement on the portals piece for several years at this point and a less than ideal solution is better than just sitting on a hand waiting for something theoretically better to arrive. »
Le précédent historique des protocoles wlroots
L’intervenant rappelle que plusieurs protocoles Wayland actuels (comme wlr-data-control ou ext-image-copy-capture) ont commencé comme des protocoles wlroots avant d’être standardisés. Il cite le développeur : « Protocols that already have implementations and users end up standardized. The ones that have neither tend to still for years. » Cela justifie l’approche bottom-up.
La position de GNOME et l’avenir incertain
GNOME est peu susceptible d’adopter ce protocole, même s’il était standardisé. L’intervenant commente : « GNOME, I agree with because they can’t even go and implement like the core upstream Wayland protocols. » En revanche, KDE Plasma et Cosmic (le futur bureau de System76) pourraient l’adopter plus tôt, comme ils l’ont fait par le passé avec d’autres protocoles.
La réponse de Sebastian Wick
Un développeur Wayland (Sebastian Wick) a contesté certains arguments techniques, notamment sur l’impossibilité de créer un token d’activation via le portail. L’intervenant rapporte : « Mutter does create an activation token for the Global Shortcut Portal for activated and deactivated. » Cela montre que le débat technique n’est pas tranché.
CONCEPTS CLÉS
- Global Shortcut : Raccourci clavier qui fonctionne même quand l’application n’est pas au premier plan (ex : push-to-talk).
- Portal : Interface D-Bus standardisée par le projet XDG pour permettre aux applications d’interagir avec le bureau (paramètres, fichiers, etc.).
- Wayland protocol : Extension du protocole Wayland de base, définie dans un fichier XML, qui ajoute des fonctionnalités au compositeur.
- Upstream Wayland : Le dépôt officiel des protocoles Wayland, géré par la communauté freedesktop.org.
- Bottom-up vs top-down : Deux approches de développement : soit on standardise d’abord puis on implémente (top-down), soit on implémente d’abord puis on standardise (bottom-up).
CONCLUSION
Le protocole XXHotKeyV1 illustre un conflit de gouvernance dans l’écosystème Wayland : faut-il attendre une solution parfaite et lente (le portail) ou accepter des solutions imparfaites mais fonctionnelles (le protocole) ? L’intervenant conclut : « You don’t have to do things top-down. You can do it bottom-up. That is the way that things have been done in the past. » Pour l’administrateur système, cela signifie que les raccourcis globaux sur Wayland restent un problème non résolu, mais que des solutions existent déjà pour les compositeurs et applications prêts à les adopter, sans attendre une standardisation officielle.