## ZaneyOS 🟰 Mejores Configs ❄️ NixOS
\*\* Actualizado: 16 de enero de 2026
ZaneyOS es una forma sencilla de reproducir mi configuración en cualquier sistema NixOS.
Incluye el fondo de pantalla, scripts, aplicaciones, archivos de configuración y más.
### Chuletas y Guías
- Guía para Principiantes de Nix: [English](cheatsheets/nix-beginner-guide.md) | [Español](cheatsheets/nix-beginner-guide.es.md)
- Guía de Personalización de Hyprland: [English](cheatsheets/hyprland-customization-guide.md) | [Español](cheatsheets/hyprland-customization-guide.es.md)
#### 🍖 Requisitos
- Debes estar ejecutando NixOS, versión 23.11+.
- Se espera que la carpeta `zaneyos` (este repo) esté en tu directorio home.
- Debes haber instalado NixOS usando partición **GPT** con arranque **UEFI**.
- ** Se requiere un /boot de mínimo 500MB. **
- Se soporta systemd-boot.
- Para GRUB tendrás que buscar una guía en internet. ☺️
- Edición manual de archivos específicos de tu host.
- El host es la máquina específica donde estás instalando.
#### 🎹 PipeWire y controles del centro de notificaciones
- Usamos la solución de audio más reciente y robusta para Linux. Además, tendrás
controles de medios y volumen en el centro de notificaciones en la barra superior.
#### 🏇 Flujo optimizado y Neovim simple pero elegante
- Usando Hyprland para mayor elegancia, funcionalidad y eficiencia.
- No hay un proyecto Neovim masivo aquí. Es mi configuración simple, fácil de entender y
excelente, con soporte de lenguajes ya añadido.
#### 🖥️ Configuración multi‑host y multi‑usuario
- Puedes definir ajustes separados para diferentes máquinas y usuarios.
- Especifica fácilmente paquetes extra para tus usuarios en `modules/core/user.nix`.
- Estructura de archivos fácil de entender y configuración simple pero abarcadora.
#### 👼 Una comunidad increíble centrada en el soporte
- La idea de ZaneyOS es hacer de NixOS un espacio accesible.
- NixOS es una gran comunidad de la que querrás formar parte.
- Muchas personas pacientes y con ganas de ayudar te apoyan usando ZaneyOS.
- No dudes en pasar por el Discord para pedir ayuda.
#### 📦 ¿Cómo instalo paquetes?
- Puedes buscar en [Nix Packages](https://search.nixos.org/packages?) y
[Options](https://search.nixos.org/options?) para conocer el nombre del paquete
o si tiene opciones que faciliten su configuración.
- Para añadir un paquete hay secciones en `modules/core/packages.nix` y
`modules/core/user.nix`. Uno para programas disponibles a nivel del sistema y
otro sólo para el entorno del usuario.
#### 🙋 ¿Problemas / Preguntas?
- Siéntete libre de abrir un issue en el repo. Por favor etiqueta las solicitudes
de funcionalidades comenzando el título con [feature request], ¡gracias!
- Contáctanos también en [Discord](https://discord.gg/XhZmNTnhtp) para una respuesta potencialmente más rápida.
# Atajos de Hyprland
A continuación los atajos de Hyprland, en formato de referencia rápida. La columna de la derecha muestra atajos específicos de **Noctalia Shell** (solo disponibles cuando `barChoice = "noctalia"`).
|
## Atajos estándar
### Lanzamiento de aplicaciones
- `$modifier + Return` → Lanzar `terminal`
- `$modifier + Tab` → Alternar `Quickshell Overview` (visor de espacios con vistas en vivo)
- `$modifier + K` → Listar atajos
- `$modifier + Shift + W` → Abrir `web-search`
- `$modifier + Alt + W` → Abrir `wallsetter`
- `$modifier + Shift + N` → Ejecutar `swaync-client -rs`
- `$modifier + W` → Abrir `Navegador web`
- `$modifier + Y` → Abrir `kitty` con `yazi`
- `$modifier + E` → Abrir `emopicker9000`
- `$modifier + S` → Tomar captura de pantalla
- `$modifier + Shift + D` → Abrir `Discord`
- `$modifier + O` → Lanzar `OBS Studio`
- `$modifier + Alt + C` → Selector de color
- `$modifier + G` → Abrir `GIMP`
- `$modifier + T` → Alternar terminal con `pypr`
- `$modifier + Alt + M` → Abrir `pavucontrol`
### Gestión de ventanas
- `$modifier + Q` → Cerrar ventana activa
- `$modifier + P` → Alternar pseudo tiling
- `$modifier + Shift + I` → Alternar modo dividido
- `$modifier + F` → Alternar pantalla completa
- `$modifier + Shift + F` → Alternar modo flotante
- `$modifier + Alt + F` → Flotar todas las ventanas
- `$modifier + Shift + C` → Salir de Hyprland
### Movimiento de ventanas
- `$modifier + Shift + ← / → / ↑ / ↓` → Mover izq./der./arriba/abajo
- `$modifier + Shift + H / L / K / J` → Mover izq./der./arriba/abajo
- `$modifier + Alt + ← / → / ↑ / ↓` → Intercambiar izq./der./arriba/abajo
### Movimiento de foco
- `$modifier + ← / → / ↑ / ↓` → Mover foco izq./der./arriba/abajo
- `$modifier + H / L / K / J` → Mover foco izq./der./arriba/abajo
### Espacios de trabajo
- `$modifier + 1-10` → Cambiar al espacio 1-10
- `$modifier + Shift + Space` → Mover ventana a espacio especial
- `$modifier + Space` → Alternar espacio especial
- `$modifier + Shift + 1-10` → Mover ventana al espacio 1-10
- `$modifier + Control + → / ←` → Cambiar espacio adelante/atrás
### Ciclo de ventanas
- `Alt + Tab` → Ir a siguiente ventana / Traer activa al frente
|
## 🎨 Atajos de Noctalia Shell
_Disponibles cuando `barChoice = "noctalia"` en `variables.nix`_
- `$modifier + D` → Alternar iniciador
- `$modifier + Shift + Return` → Alternar iniciador
- `$modifier + M` → Menú de notificaciones
- `$modifier + V` → Gestor de portapapeles
- `$modifier + Alt + P` → Panel de configuración
- `$modifier + Shift + ,` → Panel de configuración
- `$modifier + Alt + L` → Bloquear pantalla
- `$modifier + Shift + Y` → Gestor de fondos
- `$modifier + X` → Menú de energía
- `$modifier + C` → Centro de control
- `$modifier + Ctrl + R` → Grabadora de pantalla
### Iniciador Rofi (Modo Waybar)
_Disponible cuando `barChoice = "waybar"` en `variables.nix`_
- `$modifier + D` → Lanzar Rofi
- `$modifier + Shift + Return` → Lanzar Rofi
### Otras características
- `$modifier + Shift + Return` (Waybar) → Iniciador de aplicaciones
- `$modifier + V` (Waybar) → Historial del portapapeles con `cliphist`
|
## Instalación:
> **⚠️ IMPORTANTE:** Estos métodos son sólo para **NUEVAS INSTALACIONES**.
> Si ya tienes ZaneyOS instalado y quieres actualizar a v2.4, consulta las [Instrucciones de actualización](#actualizar-de-zaneyos-23-a-24) más abajo.
⬇️ Instalar con script (SÓLO NUEVAS INSTALACIONES)
### 📜 Script:
Es la forma más fácil y recomendada para comenzar en **nuevas instalaciones**. El script no pretende
permitirte cambiar todas las opciones del flake ni ayudarte a instalar paquetes extra.
Está para que obtengas mi configuración con el menor riesgo de roturas y luego puedas ajustarla a tu gusto.
> **⚠️ ADVERTENCIA:** Este script reemplazará completamente cualquier directorio ~/zaneyos existente.
> NO lo uses si ya tienes ZaneyOS instalado y configurado.
Copia y ejecuta:

```
nix-shell -p git curl pciutils
```
Luego:

```
sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/main/install-zaneyos.sh)
```
#### El proceso de instalación se verá así:


#### Tras completar, puede que el escritorio se vea roto. Reinicia y verás el login así:

#### Tras iniciar sesión deberías ver algo como esto:

🦽 Proceso de instalación manual:
1. Asegura Git y Vim instalados:
```
nix-shell -p git vim
```
2. Clona este repo y entra:
```
cd && git clone https://gitlab.com/zaney/zaneyos.git -b main --depth=1 ~/zaneyos
cd zaneyos
También puedes ejecutar el script `install.sh` si quieres.
```
- _Permanece en esta carpeta para el resto de la instalación._
3. Crea la carpeta del host para tu(s) máquina(s):
```
cp -r hosts/default hosts/
git add .
```
4. Edita `hosts//variables.nix`.
5. Edita `flake.nix` y completa tu username, perfil y hostname.
6. Genera tu hardware.nix:
```
nixos-generate-config --show-hardware-config > hosts//hardware.nix
```
7. Ejecuta esto para habilitar flakes e instalar, reemplazando hostname por el perfil (p. ej. `intel`, `nvidia`, `nvidia-laptop`, `amd-hybrid` o `vm`):
```
NIX_CONFIG="experimental-features = nix-command flakes"
sudo nixos-rebuild switch --flake .#profile
```
Ahora, cuando quieras reconstruir, tienes el alias `fr` que reconstruye el flake y no necesitas estar en la carpeta `zaneyos` para que funcione.
### Reconocimientos especiales:
Gracias por toda su ayuda
- KoolDots https://github.com/LinuxBeginnings
- Jakookit https://github.com/jakookit
- Justaguylinux https://codeberg.org/Justaguylinux
- Jerry Starke https://github.com/JerrySM64
## ¡Disfruta!