====== Hyprland ======

Hyprland es un compositor de ventanas dinámico (//tiling window manager//) basado en Wayland, diseñado para ser altamente personalizable, estético y fluido. Se destaca por sus animaciones suaves, bordes redondeados y efectos de desenfoque.

  * [[https://hypr.land/|Sitio web]]

===== Instalación =====

En Arch Linux:

<code>
pacman -S hyprland
</code>

Hyprland necesita Wyaland:

<code>
pacman -S xorg-xwayland wayland
</code>

<WRAP center round info 60%>
''xorg-xwayland'' es importantísimo porque permite ejecutar aplicaciones X11 dentro de Hyprland
</WRAP>

===== Configuración =====

Fichero ''~./config/hypr/hyprland.lua''

Si hemos iniciado Hyprland, podemos recargar la configuración con el siguiente comando:

<code>
hyprctl reload
</code>

==== Distribución de teclado ====

Por defecto, hyprland viene configurado para //US Qwerty//. Si queremos ponerlo para ES Qwerty, editamos la parte del fichero de configuración ''hyrland.lua'':

<code lua>
h1.config({
    input {
        (...)
        kb_layout = "es"
        (...)
    }
}
</code>

==== Atajos de teclado ====

Podemos definir nuestros atajos de teclado en el fichero ''hyprland.lua'':

<code lua>
hl.bind("CONTROL + ALT + DELETE", hl.dsp.exec_cmd("archlinux-logout"))
</code>

Utilizando la variable ''mainMod'' con la tecla que hayamos asociado (por defecto, la tecla "Windows"):

<code lua>
hl.bind(mainMod .. " + ENTER", hl.dsp.exec_cmd("alacritty"))
</code>

  * [[https://wiki.hypr.land/Configuring/Basics/Binds/|Documentación oficial sobre atajos de teclado]]
===== Arrancar Hyprland =====

Desde TTY (''tty1'', ''tty2''...):

<code>
start-hyprland
</code>

===== Aplicaciones recomendadas =====

==== Kitty ====

Hyprland utiliza **kitty** como emulador de terminal por defecto (aunque se puede cambiar en el fichero de configuración).

==== waybar ====

Configuración por defecto en ''/etc/xdg/waybar/''.

Mejor crear:

<code>
mkdir -p ~/.config/waybar
</code>

Copia la config del sistema:

<code>
cp /etc/xdg/waybar/config.jsonc ~/.config/waybar/
cp /etc/xdg/waybar/style.css ~/.config/waybar/
</code>

Reinicia Waybar:

<code>
pkill waybar && waybar &
</code>

==== hyprpaper ====

Herramienta para establecer fondos de escritorio en Wayland.

En Arch Linux se instala mediante el paquete ''hyprpaper''.

La configuración se puede hacer en ''~./config/hypr/hyprpaper.conf''.
==== wbg ====

Herramienta sencilla para establecer un fondo de pantalla en entornos Wayland.

  * [[https://codeberg.org/dnkl/wbg|Repositorio de código]]

En Arch Linux se instala mediante el paquete ''wbg''.

==== hyprlock ====

Herramienta para bloquear la pantalla en Wayland.

En Arch Linux se instala mediante el paquete ''hyprlock''.

La configuración se puede copiar de ''/usr/share/hypr/hyprlock.conf'' a ''~/.config/hypr/hyprlock.conf''.

==== hyprshot ====

Aplicación para hacer capturas de pantalla.

Más información de esta herramienta en [[hyprshot|esta wiki]].
==== wlogout ====

Menú de salida (//logout//) para Wayland.

En Arch Linux se instala mediante el paquete ''wlogout''.

La configuración está en ''/etc/wlogout'' y se recomienda copiarla en ''~./config/wlogout'' si se va a hacer cambios.
===== Uso con NVIDIA =====

Si ejecutamos ''lsmod | grep nvidia'' y vemos:

<code>
nvidia_drm            151552  7
nvidia_modeset       2203648  13 nvidia_drm
nvidia_uvm           2453504  0
nvidia              16351232  182 nvidia_uvm,nvidia_modeset
</code>

Estaremos usando los //drivers// propietarios de Nvidia.

Necesitaremos también tener instalados los siguientes paquetes:

  * ''egl-wayland''
  * ''nvidia-utils''

===== Arrancar desde TTY =====

Añadimos en el fichero ''~./bash_profile'':

<code bash>
# Si estamos en la TTY 1 y no hay ninguna sesión gráfica activa...
if [ -z "$DISPLAY" ] && [ "$XDG_VTNR" -eq 1 ]; then
  # Define que la sesión es Wayland (ayuda a muchas apps)
  export XDG_SESSION_TYPE=wayland
  
  # Lanzamos el compositor
  exec start-hyperland
fi
</code>

Desde ese momento, si iniciamos sesión desde la primera TTY (tty1), se iniciará automáticamente el entorno gráfico con Hyprland.
===== Resolución de problemas =====

==== Consultar el registro ====

<code>
less ~/.cache/hyprland/hyprland.log
</code>

===== Recursos =====

  * [[https://www.youtube.com/watch?v=2CP_9-jCV6A|You NEED to try Hyprland on Linux RIGHT NOW | Hyprland for Newbs EP 1]]
  * [[https://www.youtube.com/watch?v=KA1jv40q9lQ|No uses Hyprland sin estas herramientas INCREÍBLES | Hyprland para principiantes EP 2]]
  * [[https://wiki.hypr.land/Useful-Utilities/|Useful Utilities (Hyperland Wiki)]]
  * [[https://www.reddit.com/r/hyprland/comments/1tg1f11/simple_all_hyprland_keybinds_menu/| Simple "all hyprland keybinds" menu]]