Atajos de teclado

Los atajos por defecto, cómo reasignarlos, los submodos resize / planes, y cómo mod "auto" elige Alt o Super.

Cada atajo es una línea en el bloque binds: "<key pattern>" "<action>". Cada atajo de abajo es reasignable; nada aquí está cableado de forma fija salvo que Escape siempre sale de un submodo (no se puede reasignar para caer en una trampa).

La tecla mod

mod "auto"

Mod es el modificador al que hace referencia cada atajo. auto (el valor por defecto) se resuelve como Alt cuando se ejecuta anidado (el compositor anfitrión se queda con Super) y Super en una sesión real (el backend DRM) — así no necesitas una configuración distinta para anidado y sesión. Sobrescríbelo explícitamente con mod "alt" o mod "super"; un valor explícito siempre gana. A lo largo de la documentación, Mod significa lo que esto resuelva.

Los patrones de tecla combinan modificadores con +: Mod, Shift, Ctrl, Alt, Super, y luego la tecla (Return, space, Tab, period, una letra, …). Los atajos siguen la letra que escribe la tecla, no la posición física — Mod+q en azerty es la tecla que escribe q.

Atajos por defecto

TeclasAcción
Mod+Returnnuevo terminal en una columna nueva
Mod+Shift+Returnnuevo terminal apilado debajo
Mod+Ctrl+Returndivide la ventana enfocada en su sitio (horizontal)
Mod+Ctrl+Shift+Returndivide en su sitio (vertical)
Mod+h/j/k/lmueve el foco
Mod+Shift+h/j/k/lmueve la ventana (crea una fila nueva en el borde superior/inferior)
Mod+Ctrl+h/j/k/lpanea la vista
Mod+Ctrl+Shift+h/j/k/lforce: expulsa una pestaña de su grupo, o empuja una ventana a un grupo adyacente
Mod+s / Mod+Shift+srecorre los presets de ancho de columna
Mod+z / Mod+Shift+zaleja / acerca el zoom por la escalera
Mod+scrollla misma escalera con la rueda del ratón (abajo = alejar, arriba = acercar)
Mod+tagrupa en pestañas / deshace las pestañas de la columna enfocada
Mod+Tab / Mod+Shift+Tabrecorre las pestañas
Mod+spacehace flotante / vuelve a tilar la ventana enfocada
Mod+falterna pantalla completa
Mod+period / Mod+commacambia al plano siguiente / anterior
Mod+rentra en el submodo resize
Mod+wentra en el submodo pan
Mod+oentra en el submodo planes
arrastrar con Mod+LeftClickmueve una ventana flotante (solo botón izquierdo)
arrastrar con Mod+RightClickredimensiona: arrastra las junturas tiladas, o la esquina de un flotante
Mod+qcierra la ventana enfocada
Mod+Shift+esalir

Reasignar

Mete las líneas que quieras en tu bloque binds. El mismo patrón que un valor por defecto = lo sobrescribe; un patrón nuevo = se añade. No vuelves a listar el resto.

binds {
    // sobrescribe un valor por defecto: que Mod+Return lance tu lanzador
    "Mod+Return" "spawn:wofi --show drun"
    // añade nuevos (estos no tienen valor por defecto — la acción existe, el atajo no)
    "Mod+Print" "spawn:grim -g \"$(slurp)\" ~/shot.png"
    "Mod+slash" "jump-to-window"
    "Mod+1" "plane-switch:1"
    "Mod+2" "plane-switch:2"
}

La cadena de acción es el mismo vocabulario que acepta atlasctl action — cualquier cosa asignable es también invocable desde un script. Las acciones que toman un argumento usan dos puntos: spawn:<cmd>, tag-toggle:<name>, plane-switch:<n>, width-set:<ratio>, mark-jump:<name>. Consulta Configuración y la referencia de configuración para la lista completa.

Submodos

Un submodo es una tabla de atajos modal (submaps de Hyprland / modes de i3). Un atajo con la acción "submap:<name>" entra en el modo; mientras está activo su tabla reemplaza a los atajos normales (normalmente teclas sueltas — sin combinaciones), las teclas sin asignar se absorben en lugar de llegar a la app enfocada, y Escape siempre sale. El atajo que entró en un submodo también lo sale (alternar), además de Escape.

Prueba el submodo pan por defecto: Mod+w, luego panea con h/j/k/l sueltas, Escape para salir.

El compositor no incluye ningún indicador en pantalla, pero el módulo de waybar atlas-submap (consulta Integración) muestra el submodo activo para que nunca te quedes atrapado en uno sin saberlo.

El submodo resize (Mod+r)

Los verbos de redimensionado apuntan de dentro hacia fuera: redimensionan lo más cercano a la ventana enfocada que flexiona en ese eje, retrocediendo hacia fuera cuando no hay nada.

Tecla (en el submodo)Acción
h / lencoge / agranda horizontalmente (la proporción de división más cercana, si no el ancho de columna)
j / kencoge / agranda verticalmente (la proporción de división más cercana, si no la de la celda, si no el alto de fila)
Shift+j / Shift+kencoge / agranda toda la fila
srecorre los presets de ancho de columna
Escape / Returnsale del submodo

Mientras el submodo resize está activo, la región que afectará el redimensionado queda delineada en pantalla (el color resize-highlight), de modo que el objetivo de-dentro-hacia-fuera nunca es una sorpresa. Los pasos provienen de resize { step-px step-share }.

El submodo planes (Mod+o)

Tecla (en el submodo)Acción
l / hcambia al plano siguiente / anterior
ncrea un plano nuevo y cambia a él
qcierra el plano activo (solo si está vacío)
Shift+l / Shift+hmueve la ventana enfocada al plano siguiente / anterior (y la sigue)
Escape / Returnsale del submodo

Tus propios submodos

Declara un submodo y un atajo para entrar en él. Añade oneshot=#true para que salga tras su primera acción (útil para un modo de "haz una cosa y quítate de en medio"); el valor por defecto es pegajoso (sticky).

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

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

Una nota sobre los valores por defecto en azerty

Los atajos por defecto plane-next / plane-prev usan Mod+period / Mod+comma. En azerty/fr, , no requiere Shift (así que Mod+comma funciona) pero . sí lo necesita (así que el keysym Mod+period a secas nunca coincide). Los keysyms de puntuación no se normalizan por distribución como sí las letras. Si usas azerty, reasigna estos a algo que encaje con tu distribución — son cambios de una línea.