💡 TL;DR
- Karabiner-Elements remappe ton clavier macOS en profondeur : touches simples, couches façon Vim, Hyper Key sur Caps Lock
- Gratuit et open source, piloté par pqrs-org, version 16.3.0 courante, installation via
brew install --cask karabiner-elementsou .dmg officiel- Demande les permissions Accessibilité et Surveillance de la saisie, plus l’activation d’un driver virtuel, et tourne léger en tâche de fond
Karabiner-Elements : c’est quoi exactement ?
Le remap de clavier natif de macOS, dans Réglages Système, te laisse échanger deux ou trois touches modificatrices. C’est tout. Si tu veux qu’une touche se comporte différemment selon l’app active, ou qu’elle envoie une combinaison entière au lieu d’un simple caractère, tu es coincé. C’est exactement le trou que Karabiner-Elements vient combler.
Karabiner-Elements est un outil tiers, pas une fonctionnalité Apple. Il est développé par pqrs-org (le mainteneur historique se fait appeler tekezo), distribué gratuitement sous licence permissive, avec le code source public sur GitHub. J’ai vérifié avant d’écrire cet article : le projet est toujours actif, la version courante est la 16.3.0, et le cask Homebrew correspondant n’est ni deprecated ni disabled. Pas un projet zombie qu’on te recommande par habitude.
Concrètement, Karabiner-Elements intercepte les événements clavier au niveau système, avant que macOS ne les traite, et les réécrit selon des règles que tu définis. Une touche simple peut devenir une autre touche. Une touche tenue peut devenir un modificateur. Et une combinaison entière peut activer une “couche”, un mode temporaire où tout le clavier change de comportement tant que tu maintiens une touche donnée. C’est cette dernière partie qui transforme un simple remapper en vraie machine à raccourcis.
Table des matières
Table des matières
Installation : Homebrew ou téléchargement direct
Deux chemins mènent au même binaire. Le premier, si Homebrew tourne déjà sur ta machine :
brew install --cask karabiner-elements
Le second, en allant chercher le .dmg directement sur la page de releases GitHub du projet, pour les cas où tu préfères éviter Homebrew ou vérifier la signature toi-même. Les deux donnent la même app, le cask Homebrew suit les releases officielles sans décalage notable.
Karabiner-Elements 16.3.0 demande macOS 13 (Ventura) ou plus récent. Si tu es encore sur un système plus ancien, les versions de la branche 10.x du projet couvrent macOS 10.9 à 12, mais tu perds les dernières fonctionnalités de génération de règles.
Une fois l’app lancée depuis le dossier Applications, macOS va te réclamer plusieurs autorisations : Surveillance de la saisie (Input Monitoring) et Accessibilité dans Réglages Système > Confidentialité et sécurité. Karabiner-Elements installe aussi un driver virtuel (Karabiner-VirtualHIDDevice) qui doit être approuvé comme extension système, parfois avec un redémarrage à la clé.
⚠️ Sans ces permissions accordées une par une, Karabiner-Elements reste silencieux et rien ne se remappe. Si une règle ne marche pas du premier coup, c’est la première chose à vérifier avant de suspecter la config.
Premiers pas : remapper une touche en douceur
Avant de te lancer dans les couches et le JSON, commence par l’onglet “Simple Modifications” de l’interface. C’est une liste déroulante, pas une ligne de code. Tu choisis une touche source, une touche cible, et c’est appliqué immédiatement, sans redémarrage.
Les classiques qui reviennent tout le temps chez les gens qui migrent depuis Windows ou Linux :
- Caps Lock vers Escape, pour les habitués de Vim qui veulent l’Echap à portée de l’auriculaire
- Caps Lock vers Control, pour ceux qui préfèrent garder un vrai modificateur accessible
- Fn vers Control, utile sur les claviers compacts
- Inversion des touches Option et Command sur un clavier externe PC
Chaque profil Karabiner-Elements peut avoir son propre jeu de remaps simples, et tu peux créer plusieurs profils, un pour ton Mac, un pour un clavier externe spécifique. Pratique si tu branches parfois un clavier mécanique qui a déjà sa propre disposition.
Complex modifications : les couches clavier qui changent tout
Les Simple Modifications couvrent le remap un pour un. Les Complex Modifications ouvrent un tout autre terrain : des règles JSON capables de conditionner un remap à l’app active, à l’état d’autres touches, ou à une séquence précise.
L’onglet Complex Modifications propose un bouton pour importer des règles prêtes à l’emploi depuis un catalogue communautaire hébergé par le projet. Tu y trouves des règles toutes faites : raccourcis façon Emacs, navigation façon Vi dans n’importe quel champ texte, protection contre un Cmd+Q accidentel, ou simulation de boutons de souris au clavier.
Le concept qui change vraiment la donne, c’est la couche (layer). Une couche, c’est une touche qui, tenue enfoncée, transforme temporairement tout ou partie du clavier en autre chose. Tu actives la couche, tu tapes une lettre qui devient une flèche ou un raccourci, tu relâches, le clavier redevient normal. C’est le principe derrière la Hyper Key : une touche habituellement sous-utilisée (Caps Lock en tête) qui, une fois tenue, envoie une combinaison de modificateurs impossible à obtenir autrement (Control + Option + Shift + Command en même temps, par exemple), libre à toi ensuite de binder cette combinaison dans Raycast, Hammerspoon ou n’importe quel launcher.
Construire sa propre couche avec Caps Lock
Voici à quoi ressemble une règle minimale qui transforme Caps Lock en Hyper Key, tout en gardant Escape si tu l’appuies seule sans rien d’autre :
{
"description": "Caps Lock -> Hyper Key (ou Escape si appui seul)",
"manipulators": [
{
"type": "basic",
"from": { "key_code": "caps_lock" },
"to": [
{
"key_code": "left_shift",
"modifiers": ["left_command", "left_control", "left_option"]
}
],
"to_if_alone": [{ "key_code": "escape" }]
}
]
}
Ce bloc vit dans ~/.config/karabiner/karabiner.json, sous profiles puis complex_modifications puis rules. Tu peux l’écrire à la main dans un éditeur de texte, ou passer par le bouton “Add rule” de l’interface qui ouvre un éditeur intégré. Karabiner-Elements 16 ajoute aussi un mode de génération de règles à partir de JavaScript, pratique si tu préfères écrire une logique plutôt qu’empiler du JSON imbriqué à la main, le moteur traduit ensuite ça vers le même format de règles sous le capot.
Une fois cette règle active, Caps Lock devient ton Hyper Key personnel. Dans Hammerspoon par exemple, j’ai lié cette combinaison à des raccourcis de gestion de fenêtres, un article que j’ai déjà détaillé si tu veux pousser l’automatisation plus loin une fois le clavier remappé.
✅ Teste toujours une nouvelle règle avec Karabiner-EventViewer ouvert à côté. Cet utilitaire, livré avec l’app, affiche en direct le code de chaque touche et chaque événement intercepté. Ça évite de deviner à l’aveugle pourquoi une règle ne se déclenche pas.
Pour des couches plus riches, type i/j/k/l qui deviennent des flèches directionnelles pendant que tu tiens une touche dédiée, le principe est le même : une condition to_if_held_down ou une variable définie par une première règle, lue par les règles suivantes. C’est plus verbeux à écrire, mais rien de magique, juste de la répétition du même schéma from / to / condition.
Permissions macOS et pièges fréquents
La plupart des blocages viennent des permissions, pas de la config. Avant de rouvrir dix fois le JSON pour chercher une faute de frappe, vérifie dans l’ordre :
- Surveillance de la saisie accordée dans Réglages Système > Confidentialité et sécurité
- Accessibilité accordée au même endroit
- L’extension système Karabiner-VirtualHIDDevice autorisée, et un redémarrage effectué après son activation
- Aucun autre outil de remap (BetterTouchTool, une config clavier au niveau du firmware d’un clavier mécanique) qui intercepte la même touche en amont
Ce dernier point piège pas mal de monde. Deux outils qui remappent la même touche à des niveaux différents produisent un comportement imprévisible : parfois la règle Karabiner-Elements gagne, parfois c’est l’autre outil, selon l’ordre de chargement. Si Caps Lock fait n’importe quoi après une mise à jour, commence par désactiver temporairement les autres remappers avant de blâmer Karabiner-Elements.
Autre piège classique : modifier karabiner.json à la main pendant que l’app tourne, sans recharger la config. L’icône dans la barre de menus propose une entrée pour relancer le service de gestion des règles si un changement ne semble pas pris en compte.
Karabiner-Elements face aux alternatives
Karabiner-Elements n’est pas seul sur ce terrain, et il ne fait pas tout. Il reste bas niveau : il remappe des touches et des combinaisons, mais il ne gère ni les fenêtres ni le lancement d’applications. Pour ça, un tiling manager comme AeroSpace macOS : le tiling façon i3 sans désactiver SIP prend le relais une fois ton Hyper Key en place : tu actives ta couche, et une touche de la couche envoie la commande de tiling.
BetterTouchTool couvre un terrain voisin avec une interface graphique plus riche et des gestures trackpad, mais c’est payant, et il est moins chirurgical sur le remap pur de touches. Le remap natif de Réglages Système reste suffisant si tu veux juste échanger deux modificateurs, mais il n’offre ni couches, ni conditions par application.
Une fois que ton clavier ne ressemble plus à celui d’origine, retenir tous tes nouveaux raccourcis devient un exercice en soi. C’est là qu’un aide-mémoire comme Cheatsheet macOS : CheatSheet est mort, KeyClu prend le relais rend service, puisque CheatSheet lui-même est abandonné. Et si tu veux des bascules système rapides sans écrire une seule règle JSON, One Switch macOS : panneau de contrôle rapide en un clic couvre un besoin complémentaire, plus simple, moins profond.
Pour une vue d’ensemble des outils macOS gratuits qui méritent une place sur ton Mac, j’ai rassemblé une liste plus large dans 10 Outils macOS gratuits que j’utilise (2026), Karabiner-Elements y figure en bonne place.
Conclusion
Karabiner-Elements demande un peu de patience au départ : des permissions à accorder, un driver à approuver, un format JSON à apprivoiser pour les règles complexes. Mais une fois la base posée, ton clavier macOS cesse d’être une contrainte figée par Apple et devient un outil que tu façonnes à ta main.
Commence petit. Un remap simple de Caps Lock, teste-le une semaine. Si tu sens que tu veux plus, passe aux Complex Modifications et à la Hyper Key. Chez moi, c’est devenu la fondation sur laquelle reposent tous mes autres outils d’automatisation macOS, et je ne reviendrais pas en arrière.