VanityOS Shell — macOS Developer Setup 🚀

Automatiza en pocos minutos un entorno de desarrollo moderno para macOS. VanityOS Shell instala Zsh optimizado, Oh My Posh, utilidades CLI esenciales, Docker Desktop con Portainer y Lazydocker, dejando tu .zshrc listo para trabajar.

---

✨ Qué incluye

• Homebrew configurado para Apple Silicon o Intel.
• Zsh + Oh My Zsh con plugins (zsh-autosuggestions, zsh-syntax-highlighting, zsh-completions).
• Oh My Posh (tema Catppuccin) + fuente Meslo Nerd Font.
• Node.js, Python, Git, direnv y herramientas base de terminal.
• yt-dlp + ffmpeg para descargas directas desde YouTube (video y audio).
• Docker Desktop, Lazydocker y despliegue automático de Portainer CE.
• Archivo .zshrc documentado para seguir personalizando tu shell.

✅ Requisitos previos

• macOS 12+ (Intel o Apple Silicon).
• Conexión estable a internet y espacio libre (~5 GB para Docker).
• Se recomienda instalar las Xcode Command Line Tools antes de iniciar:

  xcode-select --install
  

🚀 Instalación rápida

Ejecuta el instalador directamente desde la terminal (usa bash, no zsh):

curl -fsSL https://raw.githubusercontent.com/marcogll/mac_vntySet/main/vanity_setup.sh | bash

El script muestra un menú para elegir qué componentes instalar.

🧩 Opciones del menú

Opción	Descripción	Incluye
A	Instalación completa (recomendada).	Homebrew + stack Zsh + Docker/Portainer/Lazydocker.
C	Solo configura la terminal.	Homebrew + Zsh, Oh My Zsh, Oh My Posh, utilidades CLI.
D	Solo herramientas de contenedores.	Homebrew + Docker Desktop, Portainer, Lazydocker.
Q	Salir.	—

🔧 Detalles de la configuración Zsh

• Copia ~/.zshrc desde .zshrc.example (incluye comentarios en español).
• Instala los plugins necesarios y refresca sus repositorios si ya existen.
• Coloca el tema Catppuccin en ~/.poshthemes y activa Oh My Posh automáticamente.
• Copia source ~/.zshrc al portapapeles para que puedas recargar la shell al finalizar.
• Genera los directorios ~/videos/youtube y ~/musica/youtube y define alias listos para descargar con ytv <url> (video completo) y ytm <url> (solo audio MP3).
• Añade un comando help dentro de Zsh que describe el uso de estos alias.

🐳 Stack Docker + Portainer

1. Instala Docker Desktop via Homebrew Cask.
2. Inicia la app automáticamente y espera a que el daemon esté listo.
3. Instala Lazydocker (brew install lazydocker).
4. Lanza Portainer CE con los puertos 8000 y 9443. Acceso: https://localhost:9443.

Si Docker Desktop aún no ha terminado de iniciar, el script dejará Portainer pendiente y te indicará que abras la app manualmente y ejecutes de nuevo la opción D.

✅ Verificación rápida

• Recargar Zsh: source ~/.zshrc
• Comprobar Oh My Posh: el prompt debe mostrar colores y símbolos; si no, ejecuta oh-my-posh init zsh --config ~/.poshthemes/catppuccin.omp.json.
• Verificar Docker: docker info
• Confirmar Portainer: abre https://localhost:9443 en el navegador.
• Lanzar Lazydocker: lazydocker
• Descargar un video de prueba: ytv https://youtu.be/<ID>
• Descargar solo audio: ytm https://youtu.be/<ID>
• Ver ayuda rápida: ejecuta help

🧰 Personalización

• Edita ~/.zshrc para añadir alias o funciones propios; el archivo viene por secciones comentadas.
• Cambia el tema de Oh My Posh apuntando a otro .omp.json (guárdalo en ~/.poshthemes).
• Añade paquetes con brew install <formula>; el shell ya tiene Homebrew disponible.

❗️ Solución de problemas

• “command not found: brew”: ejecuta eval "$(/opt/homebrew/bin/brew shellenv)" (o /usr/local/bin/brew) y vuelve a correr la opción deseada.
• Docker no arranca: abre manualmente Docker Desktop desde Launchpad y espera a que el icono indique “Running” antes de reintentar la opción D.
• Oh My Posh sin fuente correcta: instala Meslo manualmente desde ~/Library/Fonts o selecciona Meslo LG S DZ Nerd Font en tu terminal.
• Conflictos con un .zshrc previo: el instalador hace backup implícito sobrescribiendo ~/.zshrc. Asegúrate de versionar tu archivo antes si necesitas conservarlo.

🧽 Desinstalación rápida

• Elimina Portainer: docker stop portainer && docker rm portainer && docker volume rm portainer_data.
• Borra la config Zsh (opcional): rm -rf ~/.oh-my-zsh ~/.poshthemes ~/.zshrc.
• Desinstala apps con Homebrew: brew uninstall --cask docker o brew uninstall lazydocker oh-my-posh.

📄 Licencia

Distribuido bajo la licencia MIT. Consulta LICENSE para más detalles.