68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
# 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:
|
|
|
|
```nix
|
|
[
|
|
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:
|
|
|
|
```nix
|
|
# 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:
|
|
|
|
```nix
|
|
"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.
|
|
|