mirror of
https://github.com/marcogll/scripts_mg.git
synced 2026-01-13 13:25:15 +00:00
Updated README for Omarchy Zsh Setup to version 2.8.1, including new features, installation instructions, and improved error handling.
12 KiB
12 KiB
🚀 Omarchy Zsh Setup Script v2.8.1
Script de instalación y configuración completa para Omarchy Linux con Zsh, Oh My Posh, y todas las herramientas esenciales.
Versión unificada que combina la estética Catppuccin con la robustez y características de versiones anteriores.
⚡ Instalación rápida
bash <(curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/omarchy_zsh_setup/omarchy-setup.sh)
✨ Características
🎨 Terminal y Shell
- Zsh + Oh My Zsh + plugins (autosuggestions, syntax-highlighting)
- Oh My Posh con tema Catppuccin Frappe desde AUR
- Configuración
.zshrcpersonalizada desde GitHub - Aliases útiles para Arch, Git, Docker, NPM, Python, ZeroTier
🔐 Seguridad y Red
- ZeroTier One con configuración interactiva desde AUR
- GNOME Keyring configurado para Git/SSH
- Configuración automática de claves SSH con el agente
🛠️ Desarrollo
- Git, Docker, Docker Compose
- Node.js, NPM
- Python, pip, virtualenv, Go
- yay (AUR helper)
😊 Utilidades
- yt-dlp para descargar audio/video de YouTube
- Fastfetch, htop, btop para monitoreo del sistema
- eza, bat, zoxide, tree para navegación mejorada
- playerctl, brightnessctl, pamixer para control multimedia
📦 Servicios
- Docker configurado y usuario añadido al grupo
- TeamViewer servicio habilitado
- ZeroTier One VPN configurada
📦 Paquetes instalados
Ver lista completa (click para expandir)
Sistema Base
- zsh, zsh-completions
- oh-my-posh-bin (desde AUR)
- git, curl, wget
- yay (AUR helper, compilado desde AUR)
Desarrollo
- python, python-pip, python-virtualenv
- nodejs, npm
- go (Golang)
- docker, docker-compose
- base-devel (herramientas de compilación)
Utilidades de Terminal
- eza (ls mejorado)
- bat (cat mejorado)
- zoxide (cd inteligente)
- fastfetch (info del sistema)
- htop, btop (monitores del sistema)
- tree (visualización de directorios)
Multimedia y Control
- yt-dlp, ffmpeg
- playerctl, brightnessctl, pamixer
- audacity, inkscape
Red y Seguridad
- zerotier-one (desde AUR)
- gnome-keyring, libsecret, seahorse
- lsof, net-tools
- teamviewer
Utilidades del Sistema
- nano, unzip, tar
- p7zip, unrar
Instalaciones Adicionales
- speedtest-cli (vía pip)
🎯 Durante la instalación
El script ejecuta los siguientes pasos:
- Verificación de requerimientos (root, Arch Linux, conexión a Internet)
- Instalación de paquetes base desde repositorios oficiales
- Instalación de yay desde AUR (si no está instalado)
- Configuración de Docker (servicio y permisos de usuario)
- Instalación de Oh My Zsh y plugins
- Configuración de .zshrc y tema Catppuccin desde GitHub
- Configuración de TeamViewer (servicio)
- Instalación de ZeroTier One desde AUR (opcional)
- Configuración de GNOME Keyring (opcional)
- Configuración de claves SSH (opcional)
Preguntas interactivas:
- ZeroTier Network ID: Si deseas unirte a una red ZeroTier (opcional)
- GNOME Keyring: Si deseas configurar el almacén de contraseñas
- Claves SSH: Si deseas añadir claves SSH existentes al agente
🔑 GNOME Keyring
El keyring guarda contraseñas de forma segura:
- Git (credential helper)
- SSH keys (almacenadas de forma segura)
- Aplicaciones GNOME
Configuración automática:
El script configura automáticamente:
- PAM para auto-desbloqueo del keyring
- Inicio automático de gnome-keyring-daemon
- Integración con SSH agent
Comandos útiles:
# Abrir gestor de contraseñas
seahorse
# Ver estado del keyring
gnome-keyring-daemon --version
# Comandos de ZeroTier (aliases en .zshrc)
zt # Alias de sudo zerotier-cli
ztstatus # Ver redes conectadas (listnetworks)
ztinfo # Info del nodo (info)
⚙️ Configuración incluida
Aliases de Arch Linux
pacu # Actualizar sistema
paci <pkg> # Instalar paquete
pacr <pkg> # Remover paquete
pacs <query> # Buscar paquete
yayu # Actualizar AUR
yayi <pkg> # Instalar desde AUR
Git shortcuts
gs # git status
ga # git add
gc # git commit
gcm "msg" # git commit -m
gp # git push
gl # git pull
gco <branch> # git checkout
gcb <branch> # git checkout -b
glog # git log gráfico
gac "msg" # add + commit
Docker
dc # docker compose
d # docker
dps # docker ps -a
di # docker images
dex <name> sh # docker exec -it
dlog <name> # docker logs -f
Python
py # python
venv create # Crear .venv
venv on # Activar
venv off # Desactivar
pir # pip install -r requirements.txt
pipf # pip freeze > requirements.txt
yt-dlp
ytm <URL> # Descargar audio MP3 320kbps
ytm "lofi beats" # Buscar y descargar
ytv <URL> # Descargar video MP4 (calidad por defecto)
ytv <URL> 1080 # Descargar video en 1080p
ytv <URL> 720 # Descargar video en 720p
ytls # Listar últimos descargas
Descargas en: ~/Videos/YouTube/{Music,Videos}/
NPM
nrs # npm run start
nrd # npm run dev
nrb # npm run build
nrt # npm run test
ni # npm install
nid # npm install --save-dev
nig # npm install -g
Utilidades
mkcd <dir> # mkdir + cd
extract <file> # Extraer cualquier archivo
killport <port> # Matar proceso en puerto
serve [port] # Servidor HTTP (default 8000)
clima # Ver clima Saltillo
🌐 ZeroTier Network ID
Tu Network ID tiene formato: a0cbf4b62a1234567 (16 caracteres hex)
Dónde encontrarlo:
- Ve a https://my.zerotier.com
- Selecciona tu red
- Copia el Network ID
Después de la instalación:
- Ve a tu panel de ZeroTier
- Busca el nuevo dispositivo
- Autorízalo marcando el checkbox
Comandos útiles:
# Ver redes
ztstatus
# Unirse a red
sudo zerotier-cli join <network-id>
# Salir de red
sudo zerotier-cli leave <network-id>
# Info del nodo
ztinfo
📂 Estructura creada
$HOME/
├── .zshrc # Configuración de Zsh (descargado desde GitHub)
├── .zshrc.local # Config local (opcional, no creado automáticamente)
├── .oh-my-zsh/ # Oh My Zsh
│ └── custom/plugins/ # Plugins adicionales
│ ├── zsh-autosuggestions/
│ └── zsh-syntax-highlighting/
├── .poshthemes/ # Temas Oh My Posh
│ └── catppuccin.omp.json # Tema Catppuccin Frappe
├── .zsh_functions/ # Funciones personalizadas (directorio creado)
├── Videos/YouTube/ # Descargas de yt-dlp
│ ├── Music/ # Audios MP3
│ └── Videos/ # Videos MP4
├── .ssh/ # Claves SSH (si existen)
└── omarchy-setup.log # Log de instalación
🔄 Después de la instalación
1. Reiniciar sesión o terminal (IMPORTANTE)
⚠️ REINICIO REQUERIDO si se instalaron servicios como TeamViewer o ZeroTier.
# Cerrar y volver a abrir la terminal para usar Zsh
# O cerrar sesión y volver a entrar para aplicar:
# - Cambio de shell a Zsh
# - Grupos (docker)
# - Permisos del sistema
2. Verificar instalación
# Ver versión de Zsh
zsh --version
# Ver tema Oh My Posh
oh-my-posh version
# Verificar Docker
docker ps
# Ver ZeroTier (si se configuró)
ztstatus
# Ver TeamViewer (si se instaló)
teamviewer info
# Actualizar sistema
pacu
3. Configuraciones opcionales
# Crear archivo de configuración local
nano ~/.zshrc.local
# Ejemplo de contenido:
export OPENAI_API_KEY="sk-..."
export GITHUB_TOKEN="ghp_..."
alias miproyecto="cd ~/Projects/mi-app && code ."
🛠️ Solución de problemas
Docker no funciona sin sudo
# Verificar que estás en el grupo docker
groups # Debe incluir 'docker'
# Si no aparece, reinicia sesión o ejecuta:
newgrp docker
# Verificar acceso
docker ps
Git sigue pidiendo contraseña
# Verificar credential helper
git config --global credential.helper
# Debe ser: libsecret
# Si no, configurar:
git config --global credential.helper libsecret
# Abrir Seahorse y verificar keyring
seahorse
# Verificar que el keyring está corriendo
pgrep -u "$USER" gnome-keyring-daemon
ZeroTier no conecta
# 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
# Verificar instalación
which oh-my-posh
oh-my-posh version
# Verificar que el tema existe
ls ~/.poshthemes/catppuccin.omp.json
# Verificar que tienes una Nerd Font instalada
# (El script NO instala fuentes automáticamente)
fc-list | grep -i nerd
# Si no tienes Nerd Font, instala una:
# - Nerd Fonts: https://www.nerdfonts.com/
El shell no cambió a Zsh
# Verificar shell actual
echo $SHELL
# Cambiar manualmente
chsh -s $(which zsh)
# Cerrar y abrir nueva terminal
📚 Recursos
- Arch Wiki: https://wiki.archlinux.org/
- Oh My Zsh: https://ohmyz.sh/
- Oh My Posh: https://ohmyposh.dev/
- Catppuccin Theme: https://github.com/catppuccin/catppuccin
- ZeroTier: https://www.zerotier.com/
- yt-dlp: https://github.com/yt-dlp/yt-dlp
- Nerd Fonts: https://www.nerdfonts.com/ (requerido para iconos del prompt)
- yay AUR Helper: https://github.com/Jguer/yay
🆘 Soporte
Si encuentras problemas:
- Revisa los logs del script durante la instalación
- Verifica que cerraste sesión después de instalar
- Comprueba que los grupos se aplicaron:
groups - Abre un issue en: https://github.com/marcogll/scripts_mg/issues
📝 Changelog
v2.8.1 (2025-11-02)
- Versión unificada con estética Catppuccin
- Instalación mejorada de paquetes con manejo de errores robusto
- oh-my-posh instalado desde AUR automáticamente
- Configuración
.zshrcdescargada desde GitHub - Instalación de plugins Zsh mejorada
- Configuración de ZeroTier One desde AUR
- Configuración opcional de GNOME Keyring y SSH
- Nota importante: Instalación de Nerd Fonts omitida (requiere instalación manual)
- Script no se detiene ante errores menores, continúa con advertencias
- Mejor manejo de errores en instalación de paquetes individuales
📄 Licencia
MIT License - Libre de usar y modificar
👤 Autor
Marco
- GitHub: @marcogll
- Repo: scripts_mg
# Instalar en una línea
bash <(curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/omarchy_zsh_setup/omarchy-setup.sh)
📝 Notas importantes
- Fuentes Nerd Font: El script NO instala fuentes automáticamente. Asegúrate de tener una Nerd Font instalada manualmente para que los iconos del prompt se vean correctamente.
- Reinicio requerido: Si se instalaron servicios como TeamViewer o ZeroTier, se recomienda reiniciar el sistema.
- Shell por defecto: El script verifica si zsh es el shell por defecto, pero no lo cambia automáticamente para evitar bloqueos. Ejecuta manualmente
chsh -s $(which zsh)si es necesario.
🚀 ¡Disfruta tu nuevo setup de Omarchy con Catppuccin!