---
title: Configuración Post Instalación e Inicio Rápido de Hyprland
description: Tareas comunes después de la instalación y resumen de atajos de teclado
ai_translated: true
---

import { Kbd } from 'starlight-kbd/components'
import ImageComponent from '~/components/image-component.astro';
import { Aside } from '@astrojs/starlight/components';

:::note
Hyprland es un compositor wayland que soporta varios diseños como dwindle (tiling), scrolling, master, monocle y diseños personalizados. **No** es un entorno de escritorio completo (DE).
:::

### ¿Por qué usar Hyprland?

Hyprland es un hermoso gestor de tiling dinámico que ofrece una variedad de diseños y funcionalidad avanzada de compositor como VRR, tearing y HDR. Los dots de CachyOS para Hyprland están configurados con valores predeterminados generales que deberían ser completamente utilizables sin configuración adicional, con aplicaciones que siguen el tema general del sistema.

**Dotfiles mantenidos por [Jinra](https://github.com/Jinra)**

Para problemas relacionados con Noctalia, consulta la [documentación de Noctalia](https://docs.noctalia.dev/).

## Tareas Post Configuración
Querrás configurar algunas cosas específicas del usuario después de la configuración. Para configuraciones adicionales, consulta el wiki de Hyprland https://wiki.hypr.land/Configuring/Start/

### Ubicación `~/.config/hypr/config`
* `monitors.lua` configurará tus monitores. (más información en https://wiki.hypr.land/Configuring/Basics/Monitors/). Se crea un bloque predeterminado para ti, puedes añadir más para monitores adicionales.
  * `output` edita `variables.lua` en su lugar con el valor del monitor; puedes ejecutar `hyprctl monitors` para obtener este id (p. ej. `DP-1`). Si añades más monitores usa MONITOR2, MONITOR3, etc y añádelos también a `variables.lua`.
  * `mode` debe estar en un formato como `1920x1080@60` (horizontal x vertical @ tasa de refresco).
  * `scale` Lo más probable es que quieras `1`, pero puede que quieras un valor más alto para monitores de mayor resolución.
  * Puede que necesites reiniciar después del primer ajuste, pero los ajustes futuros deberían reflejarse en vivo.
* `variables.lua`
  * Añade tus asignaciones de monitores aquí. Tu `PRIMARY_MONITOR` y `MONITOR1` generalmente deberían ser el mismo monitor. Puedes eliminar/añadir variables `MONITOR#` según sea necesario.
  * Define tu número de espacios de trabajo por monitor. No excedas 10.
* `input.lua` Puedes definir tus varios ajustes de entrada de hypr aquí. Probablemente quieras ajustar la `sensitivity`.
* `binds.lua` Revisa este archivo para ver todos los atajos de teclado de estos dots. También puedes consultar el resumen general a continuación.
* `windowrules.lua` Si te preguntas por qué ciertas ventanas tienen ciertos comportamientos, revisa este archivo; también puedes añadir/eliminar reglas según consideres oportuno.
* `workspaces.lua` Añade varios ajustes de espacio de trabajo aquí. Se recomienda añadir 3 espacios de trabajo por monitor (como se muestra en los ejemplos) más el espacio de trabajo de juegos al monitor principal.
* `environment.lua` se usa para establecer variables de entorno específicas de hypr o del usuario. No es necesario ajustarlo si estás usando UWSM, y es más preferible añadir estas al archivo env de UWSM en su lugar (ver abajo).
### Ubicación `~/.config/uwsm`
* `env` es un archivo usado para definir variables globales, puedes usarlo para variables generales que necesitan ser asignadas para tu cuenta de usuario específica (Ejemplos: `HYPRCURSOR_THEME`, `XCURSOR_THEME`, `QT_QPA_PLATFORM`, etc.)
### Ubicación `~/.config/noctalia` (Solo V5; V4 tendrá archivos aquí, pero no necesitas tocarlos ya que pueden configurarse a través de los ajustes de Noctalia)
* `config.toml` es donde vive la configuración predeterminada para cachyos-hypr-noctalia. Si te preguntas por qué los valores predeterminados difieren de una instalación vanilla de noctalia v5, esta es la razón. No deberías tener que tocar nada en este archivo.
### Ubicación `ajustes de noctalia` (Super + Z)
* Puedes editar los ajustes de Noctalia aquí. Se recomienda ir a la sección de plantillas y activar cualquier plantilla de color para las aplicaciones que puedas usar.
* También echa un vistazo a la tienda de plugins para plugins oficiales y de la comunidad útiles.

## Atajos de Teclado

La mayoría de las combinaciones de teclas requieren el uso de la tecla mod que en nuestro caso es la tecla Windows/Command (referenciada como SUPER), puedes cambiarla en `binds.lua`.

### Gestión de Ventanas

| Descripción | Tecla |
|-------------|-----|
| Forzar cierre de app/ventana (mantén la combinación y haz clic) | <Kbd linux="Super+Escape" /> |
| Cerrar ventana/app enfocada | <Kbd linux="Super+Q" /> |
| Alternar flotante/tiling | <Kbd linux="Super+Alt+Space" /> |
| Maximizar ventana enfocada | <Kbd linux="Super+D" /> |
| Pantalla completa ventana enfocada | <Kbd linux="Super+F" /> |
| Alternar dirección de división | <Kbd linux="Super+J" /> |
| Enfocar izquierda | <Kbd linux="Super+Left" /> |
| Enfocar derecha | <Kbd linux="Super+Right" /> |
| Enfocar arriba | <Kbd linux="Super+Up" /> |
| Enfocar abajo | <Kbd linux="Super+Down" /> |
| Cambiar enfoque de ventana en espacio de trabajo | <Kbd linux="Alt+Tab" /> |
| Abrir cambiador de ventanas | <Kbd linux="Super+Tab" /> |
| Mover ventana enfocada al monitor | <Kbd linux="Super+Shift+#" /> |
| Mover ventana enfocada al espacio de trabajo | <Kbd linux="Super+Shift+Control+#" /> |
| Mover ventana enfocada al espacio de trabajo especial | <Kbd linux="Super+Shift+S" /> |
| Mover ventana enfocada a la derecha | <Kbd linux="Super+Shift+Right" /> |
| Mover ventana enfocada a la izquierda | <Kbd linux="Super+Shift+Left" /> |
| Mover ventana enfocada arriba | <Kbd linux="Super+Shift+Up" /> |
| Mover ventana enfocada abajo | <Kbd linux="Super+Shift+Down" /> |
| Mover ventana enfocada al siguiente espacio de trabajo | <Kbd linux="Super+Control+Shift+Right" /> |
| Mover ventana enfocada al espacio de trabajo anterior | <Kbd linux="Super+Control+Shift+Left" /> |
| Mover ventana enfocada al espacio de trabajo anterior (ratón) | <Kbd linux="Super+Control+Shift+Scroll&nbsp;up" /> |
| Mover ventana enfocada al siguiente espacio de trabajo (ratón) | <Kbd linux="Super+Control+Shift+Scroll&nbsp;down" /> |
| Mover ventana enfocada al siguiente monitor | <Kbd linux="Super+Shift+Scroll&nbsp;down" /> |
| Mover ventana enfocada al monitor anterior | <Kbd linux="Super+Shift+Scroll&nbsp;up" /> |
| Mover ventana (ratón) | <Kbd linux="Super+Left&nbsp;Click" /> |
| Redimensionar ventana (ratón) | <Kbd linux="Super+Right&nbsp;Click" /> |

### Lanzador

| Descripción | Tecla |
|-------------|-----|
| Abrir Terminal | <Kbd linux="Super+Return" /> |
| Abrir Gestor de Archivos | <Kbd linux="Super+E" /> |
| Abrir Editor | <Kbd linux="Super+T" /> |
| Abrir Calculadora | <Kbd linux="Super+C" /> |
| Abrir Navegador | <Kbd linux="Super+W" /> |
| Abrir Monitor del Sistema (btop) | <Kbd linux="Control+Shift+Escape" /> |
| Alternar Ajustes de Noctalia | <Kbd linux="Super+Z" /> |
| Alternar Centro de Control | <Kbd linux="Super+X" /> |
| Alternar Lanzador de Apps | <Kbd linux="Super+Space" /> |
| Abrir Lanzador de Emoji | <Kbd linux="Super+period" /> |
| Bloquear pantalla | <Kbd linux="Super+L" /> |
| Alternar menú de sesión | <Kbd linux="Super+Alt+C" /> |

### Controles de Hardware

| Descripción | Tecla |
|-------------|-----|
| Subir Volumen | <Kbd linux="Volume Up" /> |
| Bajar Volumen | <Kbd linux="Volume Down" /> |
| Silenciar Salida de Audio | <Kbd linux="Mute" /> |
| Silenciar Entrada del Micrófono | <Kbd linux="MicMute" /> |
| Reproducir/Pausar Media | <Kbd linux="Play" /> / <Kbd linux="Pause" /> |
| Siguiente Pista de Media | <Kbd linux="Next" /> |
| Pista Anterior de Media | <Kbd linux="Previous" /> |
| Aumentar Brillo de Pantalla | <Kbd linux="Brightness Up" /> |
| Disminuir Brillo de Pantalla | <Kbd linux="Brightness Down" /> |

### Utilidades

| Descripción | Tecla |
|-------------|-----|
| Selector de Color | <Kbd linux="Super+P" /> |
| Captura de Pantalla y Anotar | <Kbd linux="Print" /> |
| Captura de Ventana y Anotar (v4) | <Kbd linux="Super+Print" /> |
| Captura de Monitor y Anotar (v5) | <Kbd linux="Super+Print" /> |
| Alternar Grabador de Pantalla (solo v4) | <Kbd linux="Super+R" /> |
| Alternar Menú de Fondos de Pantalla | <Kbd linux="Super+Shift+W" /> |
| Abrir Historial del Portapapeles | <Kbd linux="Super+V" /> |
| Alternar Historial de Notificaciones | <Kbd linux="Super+A" /> |
| Acercar | <Kbd linux="Super+Plus" /> |
| Alejar | <Kbd linux="Super+Minus" /> |

### Espacios de Trabajo y Monitores

| Descripción | Tecla |
|-------------|-----|
| Cambiar al espacio de trabajo [1-10] | <Kbd linux="Super+[0-9]" /> |
| Mover ventana al espacio de trabajo [1-10] (seguir) | <Kbd linux="Super+Shift+[0-9]" /> |
| Mover ventana al espacio de trabajo [1-10] (no seguir) | <Kbd linux="Super+Alt+[0-9]" /> |
| Enfocar espacio de trabajo (Relativo) | <Kbd linux="Super+Control+#" /> |
| Enfocar espacio de trabajo (Absoluto) | <Kbd linux="Super+Alt+#" /> |
| Enfocar siguiente espacio de trabajo | <Kbd linux="Super+Control+Right" /> |
| Enfocar espacio de trabajo anterior | <Kbd linux="Super+Control+Left" /> |
| Enfocar primer espacio de trabajo vacío | <Kbd linux="Super+Control+Down" /> |
| Enfocar siguiente espacio de trabajo (ratón) | <Kbd linux="Super+Control+Scroll&nbsp;down" /> |
| Enfocar espacio de trabajo anterior (ratón) | <Kbd linux="Super+Control+Scroll&nbsp;up" /> |
| Enfocar siguiente monitor (ratón) | <Kbd linux="Super+Scroll&nbsp;down" /> |
| Enfocar monitor anterior (ratón) | <Kbd linux="Super+Scroll&nbsp;up" /> |
| Alternar espacio de trabajo especial (scratchpad) | <Kbd linux="Super+S" /> |

## Migración desde otro DE/WM

Si ya tienes otro DE/WM instalado, puedes migrar a estos dots con las instrucciones a continuación.

:::note
Aunque es posible usar la misma cuenta de usuario con Hyprland, se recomienda encarecidamente crear una nueva cuenta de usuario (instrucciones incluidas). Además, incluso con una nueva cuenta de usuario, puede haber conflictos de demonios con tu DE/WM anterior, por lo que es más ideal usar un solo entorno.
:::

Asegúrate de reemplazar las variables entre corchetes angulares (\<\>) a continuación, incluidos los corchetes angulares mismos.

1. Ejecuta `sudo pacman -S cachyos-hypr-noctalia`. Si te encuentras con un conflicto de paquetes con otro paquete `-settings` (como `cachyos-kde-settings`), puedes eliminar el paquete conflictivo ya que estos paquetes no afectan a los usuarios actuales.
1. Para crear un nuevo usuario ejecuta `sudo useradd -m <new_user> -s /bin/fish`. También puedes usar otro shell si prefieres (p. ej. /bin/zsh).
1. Ejecuta `sudo passwd <new_user>` para establecer una contraseña para la cuenta.
    * Si _realmente_ quieres usar la misma cuenta (altamente desaconsejado), en su lugar copia los dots a la carpeta del usuario `cp -r /etc/skel/. ~` (¡asegúrate de crear una copia de seguridad/instantánea primero!)
1. Opcionalmente instala `noctalia-greeter` o `sddm` como tu gestor de pantalla de inicio de sesión. `noctalia-greeter` se integra mejor con Noctalia, pero la configuración es ligeramente más complicada.
    * Para habilitar sddm como tu gestor de pantalla de inicio de sesión, instálalo con `sudo pacman -Syu sddm`, luego ejecuta `systemctl disable display-manager` y `systemctl enable sddm`.
    * Para instalar [Noctalia Greeter](https://github.com/noctalia-dev/noctalia-greeter), ejecuta `sudo pacman -Syu noctalia-greeter`, y sigue la sección "Setting up greetd" del documento enlazado. Después, ejecuta `systemctl disable display-manager` y `systemctl enable greetd`.
1. Reinicia y selecciona la sesión Hyprland (UWSM) desde tu gestor de pantalla de inicio de sesión.
    * Si el shell falla al cargar, intenta reiniciar una vez más.
1. Inicia sesión y sigue las [Tareas Post Configuración](/es/configuration/desktop_environments/hyprland/#tareas-post-configuración).

## Migración desde dots v4 a V5 / Actualización de tus dots

Si actualmente estás usando cachyos-hypr-noctalia con Noctalia v4 y has actualizado desde la versión de paquete 1.0 a una versión más nueva, o quieres actualizar tus dots, sigue las instrucciones a continuación.
Consulta los registros de cambios completos en el release para determinar si deberías actualizar tus dots.
https://github.com/CachyOS/cachyos-hypr-noctalia/releases

### Actualizaciones de Hypr

:::note
Una vez que migres tus atajos de teclado de v4 a v5, ya no funcionarán para llamar a las llamadas IPC de Noctalia.
:::

1. Instala `meld` si no lo tienes (`pacman -Q meld` para verificar si lo tienes).
1. Ejecuta `meld /etc/skel/.config/hypr ~/.config/hypr`.
1. Desde meld verás un resumen de todos los archivos con cambios. Los archivos azules tienen cambios, mientras que los archivos verdes son nuevos.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/meld_overview.png')} />
1. Haz clic en un archivo azul para ver los cambios a aplicar. Puedes usar tu mejor juicio para determinar qué aplicar, pero si no has hecho ningún cambio, es seguro sobrescribir todo el archivo. Haz clic en la flecha para aplicar cambios y en la x para eliminar líneas antiguas.
    <Aside type="note">Asegúrate de no sobrescribir cosas que hayas cambiado como tus ajustes de monitor.</Aside>
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge.png')} />
1. También puedes fusionar todo.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge_all_1.png')} />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/merge_all_2.png')} />
1. Cuando termines con tus cambios para el archivo, guarda y sal.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/save_exit.png')} />
1. Los archivos verdes nuevos te preguntarán dónde quieres guardarlo. Puedes guardarlo en `~/.config/hypr/config/` con el mismo nombre. Hay 4 archivos nuevos.
    * defaults.lua ahora es variables.lua. Debes mover manualmente cualquier adición/cambio personalizado al nuevo archivo.
    * keybinds.lua ahora es binds.lua. Debes mover manualmente cualquier adición/cambio personalizado al nuevo archivo.
    * input.lua ahora es inputs.lua. Debes mover manualmente cualquier adición/cambio personalizado al nuevo archivo.
    * workspaces.lua es nuevo y puede moverse limpiamente sin cambios.
    <br />
    <ImageComponent imgsrc={import('~/assets/images/v4-v5-migration/workspaces.png')} />

### Actualizaciones de Noctalia

1. Ejecuta `rm -rf ~/.config/noctalia` para eliminar las configuraciones actuales. Alternativamente, muévelas a otro lugar si crees que puedes necesitar algo ahí.
1. `cp -r /etc/skel/.config/noctalia ~/.config` copiará la nueva configuración a tu carpeta de inicio.

:::note
El único archivo importante es config.toml, así que puedes copiarlo individualmente en lugar de eliminar y reemplazar toda la carpeta cuando el paquete se actualice si quieres.
:::

### Otras Actualizaciones

Otros archivos pueden tener actualizaciones, puedes usar meld para integrarlas. Consulta el registro de cambios completo del release para ver qué más puede haber cambiado.

### Eliminar dependencias huérfanas (migración v4->v5)

Después de actualizar el paquete, las dependencias antiguas quedarán huérfanas, puedes eliminarlas ejecutando `shelly purify -o`.

### Reinicio

Reiniciar debería hacer que los cambios surtan efecto. Si el shell falla al cargar, intenta reiniciar una vez más.

## FAQ

> _"Mi historial del portapapeles no persiste a través de los reinicios"_

Necesitas configurar un almacén de secretos para que esto funcione correctamente. Kwallet está instalado por defecto pero también puedes usar gnome-keyring u otro almacén de secretos. Si quieres usar kwallet, instala `kwalletmanager` del repo, luego ábrelo y crea una nueva cartera. Es más fácil dejar la contraseña en blanco, pero también puedes configurar el desbloqueo automático con tu gestor de pantalla de inicio de sesión, lo cual está fuera del alcance de este wiki; consulta el [arch wiki](https://wiki.archlinux.org/title/KDE_Wallet#Configuration) para más detalles. Después de configurar una cartera, inicialízala en tu archivo `autostart.lua` con `hl.exec_cmd("kwalletd6")`.

> _"¿Cómo evito que satty aparezca después de tomar una captura de pantalla?"_

Puedes descartar fácilmente satty presionando ctrl + s para guardar tu captura de pantalla o ctrl + c para copiar. Si no quieres que satty aparezca en absoluto, puedes configurar la opción para copiar al portapapeles o guardar en archivo en los ajustes de Noctalia > shell > screenshot.

> _"¿Cómo cambio mi entrada de teclado?"_

Edita `inputs.lua` y añade `kb_layout`. Consulta [aquí](https://wiki.hypr.land/Configuring/Basics/Variables/#input)

> _"¿Por qué algunas opciones de tema no funcionan (iconos de Dolphin, algunos elementos QT, etc)"_

El repo predeterminado de Cachy solo proporciona `qt6ct` (QT6 Configuration Tool). Sin embargo, hay otra herramienta que funciona mejor para aplicaciones Plasma QT como dolphin, gwenview, etc. Descarga `qt6ct-kde` del AUR en su lugar y aplica el tema Noctalia con él. Esto debería hacer que tus apps de plasma tengan mejor tema en Hyprland.

> _"¿Cómo cambio mi navegador predeterminado?"_

Ejecuta `xdg-settings set default-web-browser your_browser.desktop`. Puedes encontrar el nombre del archivo desktop de tu navegador ejecutando `ls /usr/share/applications/`
