docs: update install.md to reflect dependency on mg_dotfiles

This commit is contained in:
Marco Gallegos
2026-01-09 09:58:19 -06:00
parent ac78200ad1
commit 787236d2ae

View File

@@ -1,17 +1,27 @@
# 🌀 Guía de Instalación - Omarchy Setup # 🌀 Guía de Instalación - Omarchy Setup
Este script modular automatiza la configuración de Arch Linux, instalando aplicaciones esenciales, configurando el entorno gráfico (Hyprland), y optimizando el sistema para desarrollo y multimedia. Este script modular automatiza la configuración de Arch Linux, vinculando tus **dotfiles personales** e instalando aplicaciones esenciales.
## 🚀 Requisitos Previos ## 🚀 Requisitos Previos
1. **Sistema Operativo:** Arch Linux (instalación base). 1. **Sistema Operativo:** Arch Linux (instalación base).
2. **Usuario:** Un usuario con permisos de `sudo`. 2. **Repositorio de Dotfiles:** Debes tener clonado tu repositorio personal en `~/Work/code/mg_dotfiles`.
3. **Conexión a Internet:** Necesaria para descargar paquetes. 3. **Git:** Para clonar los repositorios (`sudo pacman -S git`).
4. **Git:** Para clonar el repositorio (si no lo tienes, instálalo con `sudo pacman -S git`).
## 📥 Instalación ## 📥 Instalación
Clona el repositorio y ejecuta el script principal: El proceso recomendado consta de dos pasos: preparar tus dotfiles y ejecutar el setup.
### 1. Clonar Dotfiles (Obligatorio para Zsh/Hyprland)
El script buscará la configuración en esta ruta específica:
```bash
mkdir -p ~/Work/code
git clone https://github.com/marcogll/mg_dotfiles.git ~/Work/code/mg_dotfiles
```
### 2. Ejecutar Omarchy Setup
```bash ```bash
git clone https://github.com/marcogll/omarchy_setup.git git clone https://github.com/marcogll/omarchy_setup.git
@@ -22,10 +32,10 @@ chmod +x omarchy-setup.sh
## 🛠️ Uso del Script ## 🛠️ Uso del Script
Al ejecutar `./omarchy-setup.sh`, verás un menú interactivo con las siguientes opciones: Al ejecutar `./omarchy-setup.sh`, verás un menú interactivo:
1. **Instalar Aplicaciones:** Herramientas base, desarrollo (Node, Python), multimedia (VLC, OBS), y drivers Intel. 1. **Instalar Aplicaciones:** Herramientas base, desarrollo (Node, Python), multimedia y drivers Intel.
2. **Configurar Zsh:** Shell Zsh con Oh My Zsh, Oh My Posh y plugins. 2. **Configurar Zsh:** Enlaza `.zshrc` desde `mg_dotfiles` e instala Oh My Zsh/Posh.
3. **Docker:** Instala Docker, Docker Compose y Portainer. 3. **Docker:** Instala Docker, Docker Compose y Portainer.
4. **ZeroTier:** Configura la VPN P2P ZeroTier. 4. **ZeroTier:** Configura la VPN P2P ZeroTier.
5. **Impresoras:** Configura CUPS y drivers (especialmente Epson). 5. **Impresoras:** Configura CUPS y drivers (especialmente Epson).
@@ -33,21 +43,21 @@ Al ejecutar `./omarchy-setup.sh`, verás un menú interactivo con las siguientes
7. **Iconos:** Gestor de temas de iconos (Tela, Papirus, Candy). 7. **Iconos:** Gestor de temas de iconos (Tela, Papirus, Candy).
* **K:** Sincronizar claves SSH con GNOME Keyring. * **K:** Sincronizar claves SSH con GNOME Keyring.
* **F:** Soporte para formatos de disco (NTFS, exFAT, etc.). * **F:** Soporte para formatos de disco (NTFS, exFAT, etc.).
* **R:** DaVinci Resolve (Intel) - *Requiere descargar el ZIP manualmente en ~/Downloads*. * **R:** DaVinci Resolve (Intel) - *Requiere ZIP en ~/Downloads*.
* **H:** Configuración de Hyprland (copia archivos de configuración). * **H:** Configuración de Hyprland (enlaza desde `mg_dotfiles`).
* **T:** Plantillas de documentos. * **T:** Plantillas de documentos.
* **A) Instalar Todo:** Ejecuta la mayoría de los módulos automáticamente (excluye DaVinci Resolve). * **A) Instalar Todo:** Ejecuta la mayoría de los módulos automáticamente (excluye DaVinci Resolve).
## 📝 Notas Importantes ## 📝 Notas Importantes
* **Reiniciar Sesión:** Muchos cambios (Docker, grupos de usuario, variables de entorno) requieren cerrar sesión y volver a entrar. * **Enlace Simbólico:** Las configuraciones de **Zsh** y **Hyprland** se crean como enlaces simbólicos a `mg_dotfiles`. Cualquier cambio que hagas en tus archivos originales se reflejará inmediatamente.
* **Fuentes:** Para que la terminal se vea correctamente, asegúrate de instalar una **Nerd Font** (ej. `ttf-firacode-nerd`) y configurarla en tu terminal. * **Fuentes:** Asegúrate de instalar una **Nerd Font** (ej. `ttf-firacode-nerd`) para que los iconos se vean correctamente.
* **DaVinci Resolve:** Debes descargar el archivo `DaVinci_Resolve_Studio_*_Linux.zip` (o la versión gratuita) desde la web de Blackmagic y ponerlo en `~/Downloads` antes de ejecutar la opción **R**. * **Reiniciar:** Cierra sesión después de instalar para aplicar cambios de grupos (Docker) y variables de entorno.
## 📂 Estructura ## 📂 Estructura
* `omarchy-setup.sh`: Script principal. * `omarchy-setup.sh`: Script principal.
* `modules/`: Scripts individuales para cada tarea. * `modules/`: Scripts individuales para cada tarea.
* `hypr_config/`: Archivos de configuración para Hyprland (se copian a `~/.config/hypr`). * `doc_templates/`: Plantillas de documentos.
* `themes/`: Temas personalizados (ej. para Oh My Posh). * `themes/`: Temas de apoyo (ej. configuraciones por defecto de Oh My Posh).