Guía para Principiantes de ZaneyOS: Personalización Básica

¡Bienvenido! Esta guía es para quienes son nuevos en Nix y quieren realizar personalizaciones comunes y seguras en su instalación de ZaneyOS. Mantendremos todo simple y al grano.

Diseño del repositorio (dónde cambiar las cosas)

flake.nix: Punto de entrada del sistema. Normalmente no necesitas editarlo para ajustes cotidianos.
hosts/: Configuración por máquina.
- hosts/<tu-hostname>/
  - variables.nix: Tu panel principal (activar/desactivar funciones, establecer opciones).
  - host-packages.nix: Paquetes extra solo para esta máquina.
modules/: Bloques reutilizables para el sistema y Home Manager.
- modules/core/global-packages.nix: Paquetes instalados en todas las máquinas.
- modules/home/hyprland/binds.nix: Atajos de Hyprland.

Instalar paquetes

Dos patrones comunes:

1) Solo en esta máquina

Edita hosts/<tu-hostname>/host-packages.nix y añade el nombre del paquete:

[
  brave
  (catppuccin-vsc.override {
    variant = "mocha";
  })
  cowsay
]

2) En todas las máquinas

Edita modules/core/global-packages.nix y añade el paquete a la lista.

Ajustes de monitores (por host)

Edita hosts/<tu-hostname>/variables.nix y define la(s) línea(s) extra del monitor:

# Ejemplo: 1080p a 144 Hz en DP-1
extraMonitorSettings = "monitor=DP-1,1920x1080@144";

Cambiar atajos de Hyprland

Edita modules/home/hyprland/binds.nix. Por ejemplo, cambiar la terminal de Super+Return a Super+T:

"SUPER, T, exec, ${terminal}"

Aplicar y probar tus cambios

Preferido (específico de ZaneyOS):

zcli rebuild
- Nota: el alias fr está obsoleto.

Método manual de respaldo (funciona en cualquier instalación):

Desde la raíz del repo, reemplaza PROFILE por tu perfil (intel, nvidia, nvidia-laptop, vm):
- sudo nixos-rebuild switch --flake .#PROFILE

Consejos

Si un rebuild falla, lee el error cerca del final: suele apuntar al archivo/línea exacta.
Si un cambio rompe tu sesión tras reiniciar, elige una “generación” anterior en el menú de arranque.
Usa Git para versionar tus cambios y poder revertir fácilmente.

2.2 KiB Raw Blame History