303 lines
9.9 KiB
Markdown
303 lines
9.9 KiB
Markdown
[English](README.md) | [Español](README.es.md)
|
||
|
||
<div align="center">
|
||
|
||
## 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.
|
||
|
||
<img align="center" width="80%" src="img/ZaneyOS-Floating.png" />
|
||
|
||
</div>
|
||
|
||
<details>
|
||
<summary><strong>📸 Más capturas de pantalla</strong></summary>
|
||
|
||
### Temas de Waybar
|
||
|
||
<img align="center" width="80%" src="img/demo-img2.png" />
|
||
|
||
<img align="center" width="80%" src="img/demo-img3.png" />
|
||
|
||
### Integración de Noctalia Shell
|
||
|
||
<img align="center" width="80%" src="img/ZaneyOS-noctalia-panel.png" />
|
||
|
||
<img align="center" width="80%" src="img/ZaneyOS-noctalia-app.png" />
|
||
|
||
<img align="center" width="80%" src="img/ZaneyOS-noctalia-settings.png" />
|
||
|
||
<img align="center" width="80%" src="img/ZaneyOS-noctalia-weather.png" />
|
||
|
||
### Características adicionales
|
||
|
||
<img align="center" width="80%" src="img/ZaneyOS-keybind-search.png" />
|
||
|
||
<img align="center" width="80%" src="img/ZaneyOS-nivim-emacs.png" />
|
||
|
||
</details>
|
||
|
||
<div align="center">
|
||
|
||
### 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"`).
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%">
|
||
|
||
## 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
|
||
|
||
</td>
|
||
<td width="50%">
|
||
|
||
## 🎨 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`
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
## 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.
|
||
|
||
<details>
|
||
<summary><strong> ⬇️ Instalar con script (SÓLO NUEVAS INSTALACIONES)</strong></summary>
|
||
|
||
### 📜 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:
|
||
|
||

|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary><strong> 🦽 Proceso de instalación manual: </strong></summary>
|
||
|
||
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/<nombre-del-host>
|
||
git add .
|
||
```
|
||
|
||
4. Edita `hosts/<nombre-del-host>/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/<nombre-del-host>/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.
|
||
|
||
</details>
|
||
|
||
### 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!
|