Clavier distant ne fonctionne pas : correctifs de mappage

You're midway through diagnosing a problem and suddenly the remote keyboard types the wrong characters, special keys don't send, or modifiers like AltGr and Cmd misbehave — and nothing you do on your local machine changes it. If 'remote desktop keyboard not working' is what you typed into a search bar, this guide walks through why keyboard mapping breaks in remote sessions and how to fix it, step‑by‑step.

Comment le mappage du clavier se casse en session distante

Les problèmes de clavier en bureau à distance ne sont généralement pas des phénomènes magiques ; ils résultent de décalages entre trois éléments : le matériel et le système d'exploitation du clavier local, le layout clavier et la pile d'entrée de l'hôte distant, et le protocole ou client distant qui traduit les événements de touche. En chemin, vous pouvez perdre le mappage des touches spéciales (AltGr, Menu, Fn), des touches mortes (accents), ou le comportement des modificateurs (Command/Windows), ou la session peut envoyer un scancode incorrect.

Concepts à garder en tête :

• Scancodes vs keycodes vs caractères — Une touche physique génère un scancode. Le système hôte mappe les scancodes en keycodes puis en caractères selon le layout clavier actif. Les protocoles distants peuvent envoyer des scancodes, des keycodes ou des caractères Unicode ; les décalages entraînent des caractères incorrects.
• Layout vs locale — « US QWERTY » vs « UK QWERTY » vs « French AZERTY » sont des mappages différents. Avoir des layouts différents sur le client et sur l'hôte provoque des symboles et de la ponctuation inversés.
• Modificateurs et touches mortes — AltGr, Compose et les touches mortes (pour les accents) sont gérés au niveau du layout/IME et cassent souvent si la session distante ne préserve pas l'IME ou la locale distante.

Contrôles rapides reproductibles (commencez ici)

Avant d'approfondir, effectuez quelques contrôles reproductibles pour localiser si le problème est côté client, côté hôte ou lié au protocole. Ces vérifications sont peu coûteuses, rapides et feront gagner du temps.

1. Confirmer les bases : Les deux machines ont‑elles le même nom de layout clavier ? Sous Windows, vérifiez Paramètres → Heure et langue → Langue → Langues préférées. Sous macOS, vérifiez Réglages Système → Clavier → Sources d'entrée. Sous Linux, vérifiez le layout local avec setxkbmap -query ou via les paramètres de votre environnement de bureau.
2. Essayez le clavier visuel (OSK) : Ouvrez le clavier visuel sur l'hôte distant (Windows : démarrer → osk.exe ; macOS : Afficher le Visualiseur de clavier ; Linux : onboard). Si le clavier visuel tape correctement, le problème se situe entre le clavier physique et la couche de traduction d'entrée distante.
3. Testez un client différent : Connectez‑vous avec un autre client distant (par exemple, si vous utilisez TeamViewer essayez une session VNC ou RDP) pour vérifier si le problème est spécifique à un protocole ou à une implémentation client.
4. Vérifiez quand cela se produit : Le mappage échoue‑t‑il seulement dans des invites élevées/admin UAC, uniquement à l'écran de connexion, ou seulement après le déverrouillage d'un économiseur d'écran ? Ces cas limites reflètent souvent des problèmes d'isolement de privilèges ou de session.

Causes et correctifs spécifiques par plateforme

Les problèmes de clavier se manifestent différemment selon la paire OS (client ↔ hôte). Ci‑dessous les schémas courants et des correctifs pratiques.

Hôte Windows

Problèmes courants : caractères inversés (par ex. @ vs "), AltGr inopérant, touches spéciales Windows ignorées.

• Paramètres RDP : Dans les clients Microsoft Remote Desktop, vérifiez Ressources locales → Clavier → Appliquer les combinaisons de touches Windows et essayez de basculer entre « Only on the remote computer » et « On this computer ». RDP a tendance à transférer les combinaisons de touches Windows mieux que certains outils commerciaux.
• Mauvais layout clavier : Assurez‑vous que l'utilisateur de la session distante a le même layout installé et sélectionné. Pour les environnements serveur, vérifiez l'entrée par défaut du système sur l'écran de connexion : HKEY_USERS\.DEFAULT\Keyboard Layout\Preload.
• UAC et applications élevées : Si les touches fonctionnent dans les applications normales mais pas dans les fenêtres élevées, exécutez l'agent distant avec les mêmes privilèges que le processus cible. Certains clients proposent « Run as administrator » pour le service/agent. Si vous utilisez TeamViewer/AnyDesk, activez « Interact with desktop » et « Send key combinations » dans les paramètres.

Client ou hôte macOS

Problèmes courants : Command/Option inversés avec Ctrl/Alt, emoji ou caractères spéciaux non envoyés, claviers non‑Apple mal mappés.

• Mappage des modificateurs : macOS utilise Command et Option là où Windows utilise Ctrl et Alt. Vérifiez les options de mappage clavier du client. Lors d'une connexion de macOS vers Windows, de nombreux clients proposent un interrupteur « Use Command as Ctrl ».
• Touch Bar et touches Fn : Les touches Touch Bar et le comportement de Fn sont locaux au Mac sauf si le client les transfère explicitement ; attendez‑vous à des différences.
• Sessions macOS distantes : Apple restreint certaines entrées virtuelles pour des raisons de sécurité ; certaines touches (contrôles média, Touch ID) ne peuvent pas être transférées vers une autre session macOS déjà connectée.

Linux/X11 et Wayland

Problèmes courants : caractères non‑ASCII, touches mortes, compatibilité Wayland.

• Outils X11 : Utilisez xev pour observer les événements de touche et confirmer si le scancode arrivé sur X correspond aux attentes. Pour des tests en console essayez showkey -k sur un terminal virtuel.
• Limitations de Wayland : Certains protocoles et clients distants (anciens serveurs VNC, certaines implémentations RDP) ne s'intègrent pas bien aux compositeurs Wayland ; la capture du clavier peut être restreinte. Si possible, revenez à une session X11 ou utilisez une solution distante compatible Wayland.
• Setxkbmap : Pour changer rapidement de layout sur l'hôte distant utilisez setxkbmap us ou setxkbmap fr et testez les modifications.

Paramètres du protocole et du client qui cassent souvent le mappage

Les outils distants gèrent l'entrée différemment. Voici ce qu'il faut vérifier pour les familles de clients populaires.

• RDP (Microsoft Remote Desktop) : RDP est généralement le plus précis pour Windows→Windows car il utilise une traduction de scancodes optimisée pour Windows. Vérifiez l'option client « Use local keyboard layout on remote session » et la stratégie de groupe du serveur pour les paramètres clavier. RDP prend aussi en charge l'entrée Unicode via le presse‑papier pour éviter les problèmes de mappage.
• VNC (RealVNC/TigerVNC) : VNC envoie souvent des keycodes bruts depuis le client ; les décalages sont fréquents lorsque le client et le serveur attendent des jeux de keycodes différents. Essayez d'activer « Send special keys directly to the server » ou changez les paramètres de keymap du serveur VNC.
• TeamViewer / AnyDesk : Les deux sont efficaces pour le NAT traversal et les connexions rapides, mais historiquement ils ont eu des problèmes sur des cas limites — touches modificateurs, AltGr et layouts multilingues. Si vous rencontrez un problème, testez la dernière version du client (TeamViewer 15.x ou AnyDesk 7.x sont des familles majeures récentes) et cherchez les options « send key combinations ». Reconnaissez quand un concurrent est supérieur : si vous avez besoin d'un mappage Windows impeccable et que vous opérez dans un datacenter Windows, RDP sera souvent plus fiable que TeamViewer ou AnyDesk.
• Tenvo (open source) : Tenvo vise un transfert d'entrée transparent et configurable ; vérifiez les paramètres Input du client et envisagez de mettre à jour vers la dernière build si une option de layout manque. Pour les téléchargements directs et les mises à jour voir /download et pour les choix d'hébergement voir /pricing.

Dépannage avancé : journaux, outils et correctifs

Si les correctifs rapides ne fonctionnent pas, collectez des preuves et appliquez des vérifications plus avancées.

Capturer et comparer les événements de touche

• Sur Linux/X11 : lancez xev sur l'hôte, appuyez sur des touches depuis le client et vérifiez les événements KeyPress et les valeurs de keysym. Exemple :

  $ xev
  KeyPress event, serial 34, synthetic NO, window 0x3e00001,
      root 0x1a2, subw 0x0, time 1234567, (85,101), root:(900,300),
      state 0x0, keycode 38 (keysym 0x61, a), same_screen YES

• Sur Windows : utilisez PowerToys Keyboard Manager de Microsoft ou un petit outil de debug/keylogger (uniquement pour des tests — évitez d'enregistrer des entrées sensibles) pour observer les virtual key codes (VK) et les scan codes.
• Enregistrez les noms de layout exactement : par ex. « English (United States) - US QWERTY » ou « French - AZERTY ». Le nom exact aide vos collègues à reproduire le problème.

Registre et corrections bas‑niveau sur Windows

Si une touche matériel est remappée en permanence ou si les touches mortes sont incorrectes, vérifiez la scancode map à :

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Keyboard Layout\Scancode Map

Modifier le registre est risqué ; exportez d'abord la clé. Pour des tests temporaires préférez PowerToys ou le remappage avec Microsoft Keyboard Layout Creator. Si un agent distant ne s'exécute pas avec des privilèges de session interactive, il ne recevra pas certains événements de bas niveau — exécutez l'agent en tant que service avec les droits appropriés.

Problèmes d'IME et de changement de langue

Les utilisateurs internationaux voient souvent le changement d'IME casser dans les sessions distantes. Si vous dépendez d'un IME complexe (IME japonais, Pinyin chinois), confirmez que l'IME est installé et activé sur l'hôte distant et envisagez l'utilisation du collage via le presse‑papier pour les saisies complexes comme solution de contournement à court terme.

Prévention et bonnes pratiques

Une fois le problème immédiat résolu, prenez des mesures pour réduire les récurrences.

• Standardiser les layouts : Dans la mesure du possible, alignez les layouts clavier client et hôte. Pour des serveurs multi‑utilisateurs, documentez un layout standard comme « US QWERTY » pour éviter les surprises.
• Maintenez les clients à jour : Beaucoup de bugs clavier sont côté client et sont corrigés dans des releases de maintenance. Utilisez les versions stables les plus récentes (beaucoup d'apps commerciales sont sur des familles 7.x ou 15.x ; Tenvo propose des mises à jour sur /download).
• Privilégiez le protocole adapté à votre cas d'usage : Si vous opérez principalement Windows→Windows en LAN, utilisez RDP pour le mappage le plus propre. Si vous avez besoin de NAT traversal ou de commodité cross‑platform, Tenvo, TeamViewer ou AnyDesk peuvent être préférables mais attendez‑vous à des cas limites de mappage.
• Documentez les étapes de repro : Pour votre équipe, conservez une courte checklist des étapes de reproduction (OS client et version, OS distant et version, noms exacts des layouts, touches précises qui posent problème) afin de pouvoir déposer des rapports de bug exploitables rapidement.

Comment signaler le problème (quoi inclure dans un rapport de bug)

Si vous devez ouvrir un bug auprès du fournisseur du client distant ou de votre service IT interne, incluez ce qui suit pour rendre le rapport exploitable :

1. OS client et serveur (par ex. Windows 11 22H2, macOS Ventura 13.5, Ubuntu 24.04) et versions des apps client/serveur (par ex. TeamViewer 15.52.5, AnyDesk 7.0.9).
2. Noms exacts des layouts clavier des deux côtés (la chaîne depuis les paramètres OS).
3. Étapes précises et concises de reproduction — par ex. « Connecter de macOS → Windows 10 ; appuyer AltGr+E pour taper € ; le distant tape @ à la place. »
4. Journaux et captures : joignez les logs du client (souvent disponibles via Aide → Logs) et une capture d'écran de l'OSK distant montrant le résultat lorsque vous tapez.
5. Trace bas‑niveau si possible : sortie xev ou trace des keycodes Windows mettant en évidence le décalage.

Pour Tenvo, incluez les logs du client et du serveur et la configuration exacte utilisée. Si vous voulez héberger votre propre solution distante et contrôler les versions, voyez notre guide self‑hosted à /self-hosted-remote-desktop-guide et pour les options de traversal NAT consultez /remote-desktop-without-port-forwarding.

Quand un concurrent est l'outil adapté

Aucun protocole distant n'est parfait pour tous les scénarios. Si vous avez besoin d'une fidélité clavier quasi parfaite dans un datacenter Windows ou pour du développement intensif au clavier, l'intégration native de RDP dépasse souvent les clients de type overlay. À l'inverse, si votre priorité est la prise en charge cross‑platform rapide ou le NAT traversal, Tenvo et des outils comme TeamViewer et AnyDesk offrent plus de commodité au prix de problèmes de mappage occasionnels.

Soyez honnête sur les compromis : utilisez l'outil qui correspond à l'environnement et prévoyez un plan de secours (RDP, SSH + X forwarding local, ou une solution KVM distante) pour les besoins de haute précision.

Conclusion et étapes suivantes

La plupart des problèmes « remote desktop keyboard not working » se réduisent à un décalage de layout, à des différences de traduction de protocole ou à un isolement de privilèges/session. Commencez par des contrôles simples (OSK, noms de layout, client alternatif), puis capturez les événements bas‑niveau (xev, showkey, PowerToys) si le problème persiste. N'utilisez les éditions de registre/scancode qu'en dernier recours et documentez tout pour vos rapports de bug.

Si vous souhaitez une option open‑source qui vous permet d'inspecter et d'ajuster le comportement, essayez Tenvo et récupérez les builds clients les plus récents sur /download. Pour les choix d'hébergement et les considérations de coût, voyez /pricing. Si votre configuration exige une fidélité Windows garantie, envisagez d'utiliser RDP pour ces connexions et utilisez des outils cross‑platform lorsque vous avez besoin de NAT traversal ou d'assistance distante simple.

Toujours bloqué ? Rassemblez les chaînes de version OS client/serveur, les noms exacts des layouts, un cas de reproduction court, et la sortie de xev ou PowerToys, puis ouvrez un ticket auprès de votre fournisseur ou de l'équipe IT — des preuves détaillées accélèrent la résolution.

Prêt à essayer un client que vous pouvez inspecter et configurer ? Téléchargez Tenvo et testez votre routage clavier sur /download.