Instalar / Actualizar / Desinstalar

Instalación

Antes de empezar

Esto solo proporciona personalización a nivel de usuario. La instalación de GNOME probablemente te dará algunas funciones (básicas) del sistema, como red, Bluetooth, etc., pero se asume que ya las has configurado tú mismo.
EndeavourOS es recomendable para ahorrarte molestias.
- Otras distribuciones de Arch también funcionarán correctamente.
- ¿Usas una distribución no basada en Arch? Intenta encontrar la tuya en la página de Discusiones.
- ¡Nunca será necesario reinstalar tu sistema al usar Dotfiles!

Instalación automática (solo para distribuciones Arch)

Clona el repositorio, cambia a la rama ii-ags y ejecuta el script de instalación:

t=~/.cache/dots-hyprland   # No ensuciemos tu carpeta de inicio
git clone https://github.com/end-4/dots-hyprland.git "$t" --filter=blob:none
git -C "$t" checkout ii-ags
"$t"/install.sh

Para NixOS (experimental)

Actualmente, estos dotfiles no se ofrecen (todavía) como un flake.
Aunque puedes revisar el flake de NixOS de end_4
- Incluye configuración de home-manager. Querrás revisar la carpeta homes.
Consulta también https://github.com/end-4/dots-hyprland/discussions/1093

Para OpenSUSE (experimental)

Consulta https://github.com/end-4/dots-hyprland/discussions/485

Para Fedora (experimental)

Consulta la rama F42-ags de EisregenHaha/fedora-hyprland
Consulta también (discusión anterior): https://github.com/end-4/dots-hyprland/discussions/840

Instalación manual (básicamente cualquier distribución)

Clona y ve al directorio

t=~/.cache/dots-hyprland   # No ensuciemos tu carpeta de inicio
git clone https://github.com/end-4/dots-hyprland.git "$t" --filter=blob:none
cd "$t"

Obtener paquetes: Instala todos los paquetes listados como el valor del arreglo depends dentro de scriptdata/arch-packages/*/PKGBUILD. Para Arch Linux, solo usa un ayudante de AUR como yay.
Ejecuta manual-install-helper.sh para instalar el resto de las dependencias.
- También puedes instalar alternativas adecuadas como hayas descubierto, pero asegúrate de git checkout al commit requerido al instalar AGS.

Agrega el usuario al grupo video y input

sudo usermod -aG video,input "$(whoami)" # si esto de alguna manera no funciona, simplemente reemplaza "$(whoami)" con tu nombre de usuario

Copia .config, .local a tu carpeta de inicio (revisa antes de hacer esto o podrías sobrescribir tus propios archivos de configuración de manera indeseable)
Comienza con estos atajos de teclado
- Ctrl+Super+T para seleccionar un fondo de pantalla
- Super+/ para una lista de atajos de teclado. ¡Diviértete!

Después de la instalación

Detalles no tan opcionales

Temas de Qt

Selecciona KVantum en las ventanas emergentes al ejecutar:

kcmshell6 kcm_style
kcmshell6 kcm_colors

Evitar conflictos con daemons de notificación

Los daemons de notificación como dunst y mako pueden venir con las personalizaciones de tu distribución y pueden interferir con AGS si se inician primero. Se recomienda desinstalarlos si no los usas en otro lugar.

Detalles opcionales

Configuraciones adicionales

Revisa si te interesa algo en la carpeta Extras.

Integración de medios con el navegador

Si quieres que la miniatura de medios de tu navegador se muestre, obtén la extensión “Plasma Integration”.

Para Chromium
Para Firefox

Esquema de colores para ZSH

Pon esta línea en tu ~/.zshrc para soportar el esquema de colores para ZSH:

source ~/.config/zshrc.d/dots-hyprland.zsh

Iniciando Hyprland

Para iniciar Hyprland, puedes usar un gestor de pantalla (DM) o simplemente tty.
La wiki de Hyprland recomienda iniciar Hyprland con la sesión gestionada por uswm, pero yo no lo recomiendo. Usar esta opción no daña los dotfiles, pero ten en cuenta que podrías recibir mensajes no deseados de otros entornos de escritorio (por ejemplo, diálogos de autenticación duplicados).

Consulta la wiki de Hyprland para obtener más detalles. A continuación, encontrarás algunos consejos adicionales.

¿Cómo auto-iniciar Hyprland después de iniciar sesión en `tty1`?

Para ZSH o BASH, agrega esta línea al final de tu ~/.zshrc o ~/.bashrc:

source ~/.config/zshrc.d/auto-Hypr.sh

Para FISH, agrega esta línea al final de tu ~/.config/fish/config.fish:

source ~/.config/fish/auto-Hypr.fish

P.D. Se recomienda deshabilitar el DM si deseas iniciar Hyprland a través de tty.

Soy un novato. ¿Qué es un tty y DM?

Aquí hay una breve introducción para darte un acceso rápido, aunque no exactamente cierto.

Puedes ver tty como una especie de “base” de un sistema Linux. Normalmente hay 7 ttys: tty1 a tty7. Puedes presionar Ctrl+Alt+F<n> para cambiar a tty<n>, y escribir tu nombre de usuario y contraseña para iniciar sesión.

Después de iniciar sesión, puedes iniciar un entorno gráfico a través de un comando, por ejemplo, Hyprland. De hecho, la mayoría de las interfaces gráficas solo se pueden iniciar después de iniciar sesión.

Pero, ¿qué pasa si queremos una interfaz gráfica para la propia interfaz de inicio de sesión?

Entonces, aquí viene el DM (Display Manager, también llamado “LM”, es decir, Login Manager).

Algunos DM comúnmente usados:
- sddm: A menudo usado con KDE Plasma.
- gdm: A menudo usado con Gnome.
Está habilitado a nivel del sistema y se inicia automáticamente después de arrancar el sistema (aún sin iniciar sesión).
- En una distro basada en systemd, el DM generalmente está habilitado como un servicio systemd. Ejecuta lo siguiente para ver qué DM está habilitado.
```
grep 'ExecStart=' /etc/systemd/system/display-manager.service
```
  Si devuelve “No such file or directory”, entonces no hay DM habilitado, o esta no es una distribución basada en systemd.
Te proporciona una interfaz gráfica para iniciar sesión y elegir el entorno gráfico (por ejemplo, Hyprland).
- ¿Cómo sabe el DM qué entornos gráficos están disponibles?
- Normalmente, busca en la ruta /usr/share/xsessions para los de X11, y /usr/share/wayland-sessions para los de Wayland.
- Los archivos de escritorio bajo estos directorios contienen la información de los entornos gráficos.

Actualización

Instalado automáticamente

cd al directorio del repositorio
Ejecuta git pull para obtener los últimos cambios.
Ejecuta ./install.sh nuevamente
- Omite los pasos que no deseas (especialmente los rsync ... porque sobrescribirá tus archivos bajo su ruta de destino). Normalmente querrás el paso rsync que involucra .config/ags.

Ejecuta ./install.sh -h para ver más uso.

Instalado manualmente

cd al directorio del repositorio
Ejecuta git pull para obtener los últimos cambios.
Toma los archivos que desees. Normalmente querrás tomar la carpeta .config/ags.
Ejecuta manual-install-helper.sh para actualizar algunas de las dependencias.

Desinstalación

Se recomienda fuertemente la desinstalación manual.
Actualmente, hay un script para desinstalación, pero está lejos de ser perfecto y no se mantiene activamente.
Aquí va una larga explicación si te importa:

El punto es que este repositorio no es un “software” típico, sino un conjunto de configuraciones, Por lo tanto, es muy difícil hacer un script de desinstalación adecuado, que debería revertir todos los cambios realizados por el script de instalación.

Por ejemplo, el script de instalación instalará yay (AUR-helper) para ti si no tienes uno. Sin embargo, ¿qué debería hacer el script de desinstalación para revertir estos cambios?

¿Eliminar yay o yay-bin? No es adecuado, porque es posible que ya tengas uno de ellos instalado por ti mismo (NO por el script de instalación).

Incluso si el script de instalación hubiera registrado la lista de paquetes instalados por el script, aún no sería adecuado eliminar yay o yay-bin cuando el registro mostró que yay o yay-bin fue instalado por el script, porque el script no puede registrar su futuro, y es posible que hayas reinstalado yay o yay-bin otro día después de que el script de instalación haya terminado, por lo tanto, en realidad no fueron instalados por el script de instalación.

En conclusión, es casi imposible escribir un script de desinstalación adecuado. Es mejor que hagas los cambios revertidos manualmente según lo necesites.