omarchy_setup/Readme.md

🚀 Omarchy Setup Script

Script de instalación y configuración modular para Arch Linux / Omarchy con menú interactivo.

🎯 Características Principales

• ✅ Estructura Modular: Scripts independientes para cada componente.
• 🎨 Menú Interactivo: Selecciona qué instalar según tus necesidades.
• 🌀 Progreso Limpio: Las tareas en background muestran el estado sin invadir los prompts.
• 🔐 Sesión Sudo Persistente: Reutiliza la contraseña durante toda la ejecución.
• 🔧 Fácil de Extender: Agrega nuevos módulos fácilmente.

⚡ Instalación rápida

git clone https://github.com/marcogll/omarchy_setup.git
cd omarchy_setup
./omarchy-setup.sh

📂 Estructura del Repositorio

omarchy_setup/
├── omarchy-setup.sh      # Script principal con el menú interactivo.
├── modules/              # Directorio con todos los módulos de instalación.
│   ├── common.sh         # Funciones compartidas por todos los módulos.
│   ├── apps.sh           # Instalación de aplicaciones y herramientas.
│   ├── zsh-config.sh     # Configuración de Zsh, Oh My Zsh y Oh My Posh.
│   └── ...               # Otros módulos.
└── hypr_config/          # Configuración de Hyprland (copiada por el módulo).

---

📋 Módulos Disponibles

A continuación se describe cada uno de los módulos que puedes instalar.

1. Aplicaciones (apps.sh)

Este módulo instala un conjunto de aplicaciones y herramientas esenciales para un entorno de desarrollo y de escritorio completo.

• Qué instala:

  • Herramientas de sistema: git, curl, htop, fastfetch, stow, gnome-keyring.
  • Editores de código: Visual Studio Code (visual-studio-code-bin) y Cursor (cursor-bin) desde AUR.
  • Multimedia: VLC, Audacity, Inkscape y yt-dlp.
  • Red: FileZilla, Telegram y speedtest-cli.
  • Drivers de Intel: Soporte completo para gráficos Intel Iris Xe, incluyendo Mesa, Vulkan, VA-API para aceleración de video y OpenCL.
  • Utilidades de AUR: keyd (remapeo de teclado), logiops (configuración de ratones Logitech), teamviewer.

• Cómo funciona:

  • Instala paquetes desde los repositorios oficiales y AUR.
  • Configura GNOME Keyring para actuar como agente de SSH, cargando automáticamente las claves que encuentre en ~/.ssh.
  • Habilita los servicios necesarios para keyd, logiops y teamviewer.

2. Zsh (zsh-config.sh)

Transforma la terminal con Zsh, Oh My Zsh y Oh My Posh, junto con una configuración personalizada que incluye aliases y funciones útiles.

• Qué instala:

  • zsh y plugins como zsh-syntax-highlighting y zsh-autosuggestions.
  • Oh My Zsh para la gestión de la configuración de Zsh.
  • Oh My Posh como motor para el prompt, con el tema Catppuccin Frappe.
  • Herramientas de terminal como zoxide para una navegación rápida.

• Cómo funciona:

  • Instala todas las dependencias y clona los repositorios necesarios.
  • Reemplaza tu ~/.zshrc con una versión preconfigurada (creando una copia de seguridad).
  • Cambia tu shell por defecto a Zsh.

¡Importante! Después de instalar este módulo, necesitarás instalar una Nerd Font para que el prompt se vea bien. El script te recomendará instalar la fuente Meslo con el comando: oh-my-posh font install meslo.

3. Docker (docker.sh)

Instala y configura Docker para la gestión de contenedores.

• Qué instala:

  • docker y docker-compose.
  • (Opcional) Portainer, una interfaz web para gestionar Docker.

• Cómo funciona:

  • Habilita el servicio de Docker.
  • Añade tu usuario al grupo docker, lo que te permite ejecutar comandos de Docker sin sudo (requiere reiniciar sesión).
  • Te pregunta si quieres instalar Portainer.

4. ZeroTier (zerotier.sh)

Instala el cliente de ZeroTier, una herramienta para crear redes virtuales seguras.

• Qué instala:

  • El paquete zerotier-one.

• Cómo funciona:

  • Habilita el servicio de ZeroTier.
  • Te ofrece unirte a una red de ZeroTier de forma interactiva después de la instalación.

5. Impresoras (printer.sh)

Instala y configura el sistema de impresión CUPS.

• Qué instala:

  • cups, cups-pdf y filtros de impresión.
  • Drivers de impresión genéricos (gutenprint, foomatic-db).
  • Drivers para impresoras Epson desde AUR.
  • avahi para la detección de impresoras en red.

• Cómo funciona:

  • Habilita los servicios de cups y avahi.
  • Añade tu usuario al grupo lp para que puedas administrar impresoras (requiere reiniciar sesión).

6. Tema de Cursor (mouse_cursor.sh)

Instala un tema de cursor personalizado y lo configura para Hyprland y aplicaciones GTK.

• Qué instala:

  • El tema de cursor Bibata-Modern-Ice.

• Cómo funciona:

  • Descarga el tema y lo instala en ~/.icons.
  • Modifica los ficheros de configuración de Hyprland (envs.conf) y GTK (gsettings).

7. Gestor de Iconos (icon_manager.sh)

Un menú interactivo para instalar y cambiar entre diferentes temas de iconos.

• Qué instala (a elección):

  • Tela (variante Nord).
  • Papirus (estándar o con colores Catppuccin).
  • Candy Icons.

• Cómo funciona:

  • Clona los repositorios de los temas de iconos desde GitHub.
  • Modifica la configuración de Hyprland (autostart.conf) para que el tema sea persistente.

8. Sincronizar Claves SSH (ssh-keyring.sh)

Añade tus claves SSH existentes al agente de GNOME Keyring para que no tengas que escribir tu passphrase repetidamente.

• Cómo funciona:
  • Inicia el gnome-keyring-daemon.
  • Busca claves privadas en ~/.ssh y las añade al agente usando ssh-add.
  • Evita añadir claves que ya estén cargadas.

9. Soporte de Formatos (disk-format.sh)

Instala herramientas para poder leer, escribir y formatear particiones con los sistemas de archivos más comunes.

• Qué instala:
  • dosfstools (para FAT), exfatprogs (para exFAT) y ntfs-3g (para NTFS).
  • Herramientas gráficas como GParted y GNOME Disks.

10. DaVinci Resolve (davinci-resolve.sh)

Un instalador especializado para DaVinci Resolve, enfocado en sistemas con GPUs de Intel.

Nota: Este módulo es complejo y requiere que hayas descargado previamente el fichero ZIP de DaVinci Resolve desde la web de Blackmagic y lo hayas colocado en tu carpeta de ~/Downloads.

• Cómo funciona:
  • Instala todas las dependencias necesarias, incluyendo librerías de ocl-icd y intel-compute-runtime.
  • Extrae el instalador, aplica parches a las librerías con patchelf y lo copia todo a /opt/resolve.
  • Crea un script "wrapper" y un acceso directo en el menú de aplicaciones para lanzar el programa con la configuración correcta.

Verificar que el keyring está corriendo

pgrep -u "$USER" gnome-keyring-daemon

### ZeroTier no conecta

```bash
# Verificar servicio
sudo systemctl status zerotier-one

# Ver logs
sudo journalctl -u zerotier-one -f

# Reiniciar servicio
sudo systemctl restart zerotier-one

# Verificar que autorizaste el nodo en https://my.zerotier.com
ztinfo
ztstatus

Oh My Posh no se muestra correctamente

Para que el tema de Oh My Posh se visualice correctamente, es esencial tener instalada una "Nerd Font". Estas fuentes incluyen los íconos y símbolos especiales que usa el prompt.

El script no instala fuentes automáticamente, pero puedes hacerlo fácilmente con el siguiente comando:

# Instalar la fuente recomendada (Meslo LGM Nerd Font)
oh-my-posh font install meslo

Después de instalar la fuente, debes configurar tu emulador de terminal para que la use. Este paso es crucial y varía según la terminal que utilices (por ejemplo, en GNOME Terminal, Konsole, Alacritty, etc., deberás ir a sus preferencias y seleccionar "MesloLGM Nerd Font").

Verificaciones adicionales:

# Verificar que oh-my-posh está instalado
which oh-my-posh

Instala una configuración personalizada para el gestor de ventanas Hyprland.

# Listar fuentes para confirmar que Meslo está instalada
fc-list | grep -i "meslo"

El shell no cambió a Zsh

# Verificar shell actual
echo $SHELL

# Cambiar manualmente
chsh -s $(which zsh)

# Cerrar y abrir nueva terminal

---

🔧 Extender el Script

Añadir un nuevo módulo es sencillo:

1. Crea tu script en la carpeta modules/ (ej. mi-modulo.sh). Asegúrate de que tenga una función principal.
2. Añádelo al menú en omarchy-setup.sh, dentro del array MODULES. Sigue el formato: "tecla"="nombre-fichero;nombre-funcion;Descripción;tipo".
   • tipo puede ser bg (para tareas en segundo plano) o fg (para tareas interactivas).

---

📄 Licencia

Este proyecto está bajo la Licencia MIT.