zaneyos/README.es.md

12 KiB
Raw Blame History

English | Español

ZaneyOS 🟰 Mejores Configs ❄️ NixOS

** Actualizado: 3 de junio de 2025

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.

📸 Más capturas de pantalla

Temas de Waybar

Integración de Noctalia Shell

Características adicionales

Chuletas y Guías

Ten en cuenta:

Este proyecto tiene un Wiki. ¡Aprende a usar ZaneyOS aquí! ddubs ha puesto mucho esfuerzo en el FAQ, así que debería ser preciso. Sin embargo, si notas que algo está mal, crea un issue o contáctanos en Discord.

🍖 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.

Hazte un favor y lee el wiki.

📦 ¿Cómo instalo paquetes?

  • Puedes buscar en Nix Packages y 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 para una respuesta potencialmente más rápida.

  • No olvides revisar el FAQ

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 + 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 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:

Comando de primera instalación de ZaneyOS

nix-shell -p git curl pciutils

Luego:

Comando del script de instalación de ZaneyOS

sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/stable-2.4/install-zaneyos.sh)

El proceso de instalación se verá así:

Primera parte de la instalación

Segunda parte de la instalación

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

Gestor de acceso

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

Ejemplo de escritorio

🦽 Proceso de instalación manual:
  1. Asegura Git y Vim instalados:
nix-shell -p git vim
  1. Clona este repo y entra:
cd && git clone https://gitlab.com/zaney/zaneyos.git -b stable-2.4 --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.
  1. Crea la carpeta del host para tu(s) máquina(s):
cp -r hosts/default hosts/<nombre-del-host>
git add .
  1. Edita hosts/<nombre-del-host>/variables.nix.

  2. Edita flake.nix y completa tu username, perfil y hostname.

  3. Genera tu hardware.nix:

nixos-generate-config --show-hardware-config > hosts/<nombre-del-host>/hardware.nix
  1. 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.

Actualizar de ZaneyOS 2.3 a 2.4

🚀 IMPORTANTE: Si ya tienes ZaneyOS 2.3, usa el sistema de actualización automatizado en lugar de reinstalar.

✅ Proceso de actualización automatizado:

ZaneyOS incluye un sistema de actualización completo que migra tu configuración de forma segura:

cd ~/zaneyos
./upgrade-2.3-to-2.4.sh

🔍 ¿Qué hace el sistema de actualización?

  1. Análisis previo: Escaneo integral de tus personalizaciones
  2. Respaldo completo: Copia total de tu configuración actual
  3. Migración automática: Conserva todos tus ajustes y personalizaciones
  4. Actualización segura: Usa la opción boot para evitar conflictos del gestor de acceso
  5. Reversión fácil: Un solo comando si algo sale mal

📋 ¿Qué se migra automáticamente?

  • ✅ Todas las configuraciones y variables de hosts
  • ✅ Configuraciones de hardware
  • ✅ Paquetes personalizados (globales y por host)
  • ✅ Temas, fondos y ajustes de monitores
  • ✅ Configuración de Git y preferencias personales
  • ✅ Preferencias de terminal con habilitación automática

⚠️ Qué requiere atención manual

  • Entradas personalizadas en flake.nix
  • Archivos de configuración personal del shell (zshrc-personal.nix, etc.)
  • Modificaciones de módulos personalizados

📚 Documentación completa

Para instrucciones detalladas, solución de problemas y seguridad:

  • Lee: UPGRADE-2.3-to-2.4.md en tu directorio zaneyos
  • Informe de análisis: Guardado automáticamente como ~/zaneyos-upgrade-analysis-TIMESTAMP.txt

🔄 Reversión sencilla

Si algo falla, vuelve a 2.3 fácilmente:

cd ~/zaneyos
./upgrade-2.3-to-2.4.sh --revert

Reconocimientos especiales:

Gracias por toda su ayuda

¡Disfruta!