Raccourcis clavier

Les raccourcis par défaut, comment les réassigner, les sous-modes resize / planes, et comment mod "auto" choisit Alt ou Super.

Chaque raccourci est une ligne du bloc binds : "<motif de touche>" "<action>". Tous les raccourcis ci-dessous sont réassignables ; rien ici n'est figé sauf que Escape quitte toujours un sous-mode (impossible de le réassigner pour en faire un piège).

La touche mod

mod "auto"

Mod est le modificateur que chaque raccourci référence. auto (la valeur par défaut) se résout en Alt en exécution imbriquée (le compositor hôte possède Super) et en Super sur une vraie session (le backend DRM) — vous n'avez donc pas besoin d'une configuration différente selon que vous êtes imbriqué ou en session. Redéfinissez-le explicitement avec mod "alt" ou mod "super" ; une valeur explicite l'emporte toujours. Dans toute la documentation, Mod désigne ce en quoi il se résout.

Les motifs de touche combinent des modificateurs avec + : Mod, Shift, Ctrl, Alt, Super, puis la touche (Return, space, Tab, period, une lettre, …). Les raccourcis suivent la lettre que la touche tape, pas la position physique — Mod+q sur azerty est la touche qui tape q.

Raccourcis par défaut

Réassignation

Déposez les lignes que vous voulez dans votre bloc binds. Même motif qu'un raccourci par défaut = remplacement ; nouveau motif = ajout. Vous ne ré-énumérez pas le reste.

binds {
    // remplacer un raccourci par défaut : faire que Mod+Return lance votre lanceur
    "Mod+Return" "spawn:wofi --show drun"
    // en ajouter de nouveaux (sans valeur par défaut — l'action existe, pas le raccourci)
    "Mod+Print" "spawn:grim -g \"$(slurp)\" ~/shot.png"
    "Mod+slash" "jump-to-window"
    "Mod+1" "plane-switch:1"
    "Mod+2" "plane-switch:2"
}

La chaîne d'action est le même vocabulaire qu'accepte atlasctl action — tout ce qui est assignable à un raccourci est aussi invocable depuis un script. Les actions qui prennent un argument utilisent un deux-points : spawn:<cmd>, tag-toggle:<name>, plane-switch:<n>, width-set:<ratio>, mark-jump:<name>. Voir Configuration et la référence de configuration pour la liste complète.

Sous-modes

Un sous-mode est une table de raccourcis modale (sous-modes Hyprland / modes i3). Un raccourci avec l'action "submap:<name>" entre dans le mode ; tant qu'il est actif sa table remplace les raccourcis normaux (typiquement des touches simples — pas d'accords), les touches non assignées sont absorbées au lieu d'atteindre l'application ciblée, et Escape quitte toujours. Le raccourci qui a fait entrer dans un sous-mode le quitte aussi (bascule), en plus d'Escape.

Essayez le sous-mode pan par défaut : Mod+w, puis déplacez-vous avec les touches simples h/j/k/l, Escape pour quitter.

Aucun indicateur à l'écran n'est fourni par le compositor, mais le module waybar atlas-submap (voir Intégration) affiche le sous-mode actif pour que vous ne restiez jamais coincé dans l'un d'eux sans le savoir.

Le sous-mode resize (Mod+r)

Les verbes de redimensionnement ciblent du plus interne vers l'extérieur : ils redimensionnent l'élément le plus proche autour de la fenêtre ciblée qui peut fléchir sur cet axe, en s'élargissant vers l'extérieur quand il n'y en a aucun.

Tant que le sous-mode resize est actif, la région qu'un redimensionnement affectera est surlignée à l'écran (la couleur resize-highlight), pour que la cible « du plus interne vers l'extérieur » ne soit jamais une surprise. Les pas proviennent de resize { step-px step-share }.

Le sous-mode planes (Mod+o)

Vos propres sous-modes

Déclarez un sous-mode et un raccourci d'entrée pour lui. Ajoutez oneshot=#true pour qu'il quitte après sa première action (pratique pour un mode « faire une chose puis dégager ») ; par défaut, un sous-mode est persistant.

binds {
    "Mod+g" "submap:groups"
}

submaps {
    groups oneshot=#true {
        "n" "spawn-new-group"
        "l" "group-next"
        "h" "group-prev"
        "Escape" "submap-exit"
    }
}

Une note sur les valeurs par défaut azerty

Les raccourcis par défaut plane-next / plane-prev utilisent Mod+period / Mod+comma. Sur azerty/fr, , est sans Shift (donc Mod+comma fonctionne) mais . nécessite Shift (donc le keysym nu Mod+period ne correspond jamais). Les keysyms de ponctuation ne sont pas normalisés selon la disposition comme le sont les lettres. Si vous êtes en azerty, réassignez-les à quelque chose qui convient à votre disposition — ce sont des changements d'une ligne.