equisdots
Menú

Escritorio Hyprland

La configuración Lua de Hyprland, atajos de teclado, gestión de monitores, scripts, capturas de pantalla y modos de GPU de la sesión equisdots.

La configuración del compositor vive en equisdots/hyprland y está escrita en Lua desde Hyprland 0.55. Cada aspecto es un módulo cargado con require(), de modo que los atajos de teclado, las animaciones o las reglas pueden editarse de forma aislada sin tocar el resto.

El mismo escritorio corre también sobre niri, el compositor de scrollable-tiling; allí la configuración es KDL y el shell, las paletas y Nyx compartidos se reutilizan sin cambios. Ver Compositor niri para ese frontend. Esta página cubre la sesión de Hyprland.

Estructura de la configuración

Archivo Propósito
hyprland.lua Punto de entrada; requiere todos los módulos y las anulaciones en tiempo de ejecución de config/.
env.lua Variables de entorno (backends de Wayland, indicadores Qt/GTK, directorios XDG).
colors.lua Paleta exportada como tabla Lua más colores de borde activo/inactivo.
variables.lua Variables principales como mainMod = "SUPER" y terminal = "kitty".
settings.lua Opciones general, decoration, input, dwindle, master, misc y xwayland.
monitors.lua Configuración de monitores; por defecto, el comodín mode = "highrr".
keybinds.lua Todos los enlaces mediante hl.bind(), organizados por categoría.
animations.lua Curvas de Bézier y definiciones de animación.
windowrules.lua Reglas de flotación, centrado, tamaño, opacidad y espacios de trabajo.
workspaces.lua Reglas de espacios de trabajo fijadas por descripción EDID y scratchpads.
autostart.lua Comandos de inicio de la sesión (hl.on("hyprland.start", ...)).
plugins.lua Cargador de plugins: evalúa los fragmentos hypr.lua activos con un SDK mod inyectado.
config/window-effects.lua Anulaciones de decoración generadas por widgets, cargadas al final.
config/gaps.lua Anulaciones de gaps/bordes generadas por widgets, cargadas al final.

Las ediciones en un archivo Lua cargado provocan una recarga completa de la configuración. Para cambios en vivo, prefiera la API en tiempo de ejecución y persista solo al asentar:

hyprctl reload
hyprctl eval 'hl.config({ general = { gaps_in = 5, gaps_out = 12 } })'

Atajos de teclado

Enlaces esenciales, todos definidos en config/hypr/keybinds.lua:

Atajo Acción
SUPER + Return Terminal (kitty)
SUPER + D Lanzador de aplicaciones
SUPER + E / SUPER + F Gestor de archivos / navegador
SUPER + Q Cerrar la ventana activa
SUPER + Space Alternar flotante
SUPER + J Alternar diseño dividido
SUPER + Arrow keys Mover el foco
SUPER + SHIFT + Arrows Mover la ventana
SUPER + CTRL + Arrows Redimensionar la ventana
SUPER + 1-9,0 Espacio de trabajo o escritorio unificado
SUPER + Page Up/Down Espacio de trabajo anterior / siguiente
SUPER + W Selector de fondos de pantalla
SUPER + SHIFT + D Panel de ajustes (editor de barra)
SUPER + SHIFT + M Panel de plugins
SUPER + SHIFT + X Lanzar xturing
SUPER + L Pantalla de bloqueo
SUPER + Escape Salir de Hyprland
Print / SUPER + Print Superposición de captura / captura completa
SHIFT + Print / SUPER + SHIFT + Print Superposición en modo edición / captura completa con edición

Los enlaces se declaran con la API de Lua:

-- config/hypr/keybinds.lua
hl.bind(mod .. "Return", hl.dsp.exec_cmd(V.terminal))
hl.bind(mod .. "D", run("bash " .. scripts .. "/qs_manager.sh", "toggle applauncher"))
hl.bind("ALT + F4", hl.dsp.window.kill())

La lista completa está en docs/quick-reference.md del repositorio, y el panel de ajustes puede regenerar config/user-keybinds.lua para entradas personalizadas.

Los atajos que aportan los plugins los evalúa plugins.lua después de los módulos del núcleo y antes de las anulaciones del usuario. Un atajo de plugin se puede reasignar o silenciar desde Plugins → Keybinds; la anulación vive en el archivo de ajustes del plugin y nunca elimina en silencio un atajo del núcleo. Ver Plugins y extensiones.

Multimonitor

monitors.lua usa la entrada comodín para que cada pantalla funcione a su tasa de refresco más alta sin configuración por máquina:

hl.monitor({ output = "", mode = "highrr", position = "auto", scale = "auto" })

Diseños guardados

Las disposiciones guardadas desde el menú de escala (SUPER + Z), el gestor de monitores (SUPER + ALT + M) o la pestaña Monitores se escriben mediante scripts/persist-display-config.sh en ~/.config/hypr/display-config, una línea por monitor:

desc|x|y|scale|mode

desc es la descripción EDID, que identifica una pantalla física incluso cuando el kernel renombra su conector. scripts/restore-monitors.sh vuelve a aplicar el diseño poco después del inicio de sesión y lo reconcilia cada dos segundos. Los monitores desconocidos conservan el diseño automático comodín.

Atajos de monitores

Atajo Acción
SUPER + ALT + I / U Enfocar el monitor siguiente / anterior.
SUPER + ALT + SHIFT + I / U Mover la ventana al monitor siguiente / anterior.
SUPER + ALT + O Intercambiar espacios de trabajo entre monitores.
SUPER + ALT + P Mover el espacio de trabajo al monitor siguiente.
SUPER + ALT + M Abrir el gestor de monitores en rofi.
SUPER + ALT + SHIFT + M Mostrar información del monitor.

Vincular espacios de trabajo

Vincule un espacio de trabajo a un monitor físico por su descripción EDID en ~/.config/hypr/workspaces.conf:

workspace = 1, monitor:desc:Your Monitor Description, default:true
workspace = 2, monitor:desc:Your Monitor Description

hyprctl monitors all imprime la cadena de descripción de cada monitor.

Escritorios unificados

Cuando hay al menos dos pantallas conectadas de la lista (ROSTER_DESCS en scripts/ws-desktops-lib.sh), las teclas numéricas cambian de escritorio en todas las pantallas a la vez. Cada pantalla conserva sus propias ventanas por escritorio. Establezca "unifiedDesktops": false en settings.json para forzar el comportamiento clásico por monitor en cualquier caso.

Control de monitores y ventanas con hyprctl

hyprctl monitors all
hyprctl reload
hyprctl clients
hyprctl cursorpos

hyprctl eval 'hl.monitor({ output = "DP-1", mode = "2560x1440@144", position = "0x0", scale = 1 })'
hyprctl eval 'hl.dispatch(hl.dsp.focus({ workspace = 2 }))'
hyprctl eval 'hl.dispatch(hl.dsp.exit())'

El shell envía los bordes de ventana en vivo mediante hyprctl eval, de modo que los cambios de paleta no reinician ventanas. Consulte Temas y paletas.

Scripts

Desplegados en ~/.config/hypr/scripts/:

Script Propósito
qs_manager.sh Gestor IPC para cada widget de Quickshell y el enrutado de espacios de trabajo.
init.sh Restauración de la sesión: vuelve a aplicar la escena activa o el último fondo de pantalla.
lock.sh Lanza el bloqueo de sesión PAM del shell (Lock.qml).
screenshot.sh Capturas de pantalla y grabación con audio virtual.
monitor-manager.sh Gestor Rofi de posicionamiento de monitores y tasa de refresco.
scale-menu.sh Selector de escala de pantalla (80% a 200%).
gpu-mode.sh Cambio de modo NVIDIA Optimus mediante envycontrol.
workspaces.sh Demonio de estado de espacios de trabajo para el shell.
reload.sh Recarga completa de QML de Quickshell.

Capturas de pantalla y grabación

Print abre la superposición interactiva: selección de área con dimensiones en píxeles en vivo y ajuste a ventanas, pantalla completa, ventana activa, un conmutador de grabación con volumen independiente de escritorio y micrófono, escaneo QR mediante zbarimg, lupa y modo edición mediante satty. La grabación usa gpu-screen-recorder con enrutado de audio virtual por PipeWire y escribe archivos MP4 en ~/Videos/Recordings/. Dependencias de la superposición: grim, slurp, satty, gpu-screen-recorder, zbarimg, pactl/PipeWire, wl-copy y ffmpeg.

Modos de GPU

En portátiles NVIDIA Optimus, SUPER + ALT + G alterna los modos integrado, híbrido y NVIDIA; SUPER + ALT + SHIFT + G abre un selector. Se requiere reiniciar o cerrar la sesión después del cambio. El instalador puede añadir una regla sudo sin contraseña para envycontrol (%wheel ALL=(ALL) NOPASSWD: /usr/bin/envycontrol -s *) para que gpu-mode.sh cambie de modo sin preguntar, y gpu-mode.sh status imprime JSON (modo, icono, tooltip) para integraciones en la barra.

Neovim

Neovim no está incluido en el repositorio: el instalador clona xscriptor-colors/nvim en ~/.config/nvim (actualícelo con git pull allí). La configuración trae sus propios módulos lua/config/, lua/plugins/ y un motor de temas en lua/themes/; theme-sync regenera lua/themes/palettes.lua y lua/config/theme.lua desde dock/palettes, de modo que el editor sigue la misma paleta que la barra, kitty, starship y VS Code. Tras el primer arranque ejecute :Lazy para instalar plugins y :Mason para los servidores LSP.

Siguientes pasos

Editar esta página en GitHub