Update README to version 2.8.1 with new features

Updated README for Omarchy Zsh Setup to version 2.8.1, including new features, installation instructions, and improved error handling.
This commit is contained in:
Marco Gallegos
2025-11-02 11:27:51 -06:00
committed by GitHub
parent b58fcbb5bf
commit 7a66a6e648

View File

@@ -1,7 +1,9 @@
# 🚀 Omarchy Zsh Setup Script # 🚀 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. 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 ## ⚡ Instalación rápida
```bash ```bash
@@ -14,33 +16,31 @@ bash <(curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/oma
### 🎨 Terminal y Shell ### 🎨 Terminal y Shell
- **Zsh** + **Oh My Zsh** + plugins (autosuggestions, syntax-highlighting) - **Zsh** + **Oh My Zsh** + plugins (autosuggestions, syntax-highlighting)
- **Oh My Posh** con tema Catppuccin - **Oh My Posh** con tema Catppuccin Frappe desde AUR
- Aliases útiles para Arch, Git, Docker, NPM, Python - Configuración `.zshrc` personalizada desde GitHub
- Aliases útiles para Arch, Git, Docker, NPM, Python, ZeroTier
### 🌐 Navegador
- Instala **Google Chrome** desde AUR
- Remueve **omarchy-chromium** automáticamente
### 🖨️ Impresora
- Drivers oficiales **Epson L4150** (ESC/P-R)
- CUPS configurado y listo para conectar
- Acceso web: `http://localhost:631`
### 🔐 Seguridad y Red ### 🔐 Seguridad y Red
- **ZeroTier One** con conexión interactiva - **ZeroTier One** con configuración interactiva desde AUR
- **GNOME Keyring** configurado (para Git, VS Code) - **GNOME Keyring** configurado para Git/SSH
- Opciones: sin contraseña, contraseña de usuario, o personalizada - Configuración automática de claves SSH con el agente
### 😊 Utilidades
- **Emoji Launcher** (rofimoji) - Presiona `SUPER + .`
- **yt-dlp** para descargar audio/video de YouTube
- Thumbnails en Nautilus para imágenes/videos/PDFs
### 🛠️ Desarrollo ### 🛠️ Desarrollo
- Git, Docker, Docker Compose - Git, Docker, Docker Compose
- Node.js, NPM (global en `~/.npm-global`) - Node.js, NPM
- Python, pip, virtualenv - Python, pip, virtualenv, Go
- Soporte para NVM - **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
--- ---
@@ -50,37 +50,43 @@ bash <(curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/oma
<summary>Ver lista completa (click para expandir)</summary> <summary>Ver lista completa (click para expandir)</summary>
### Sistema Base ### Sistema Base
- zsh, oh-my-zsh, oh-my-posh - **zsh**, **zsh-completions**
- git, curl, wget - **oh-my-posh-bin** (desde AUR)
- yay (AUR helper) - **git**, **curl**, **wget**
- **yay** (AUR helper, compilado desde AUR)
### Desarrollo ### Desarrollo
- python, python-pip, python-virtualenv - **python**, **python-pip**, **python-virtualenv**
- nodejs, npm - **nodejs**, **npm**
- docker, docker-compose - **go** (Golang)
- **docker**, **docker-compose**
- **base-devel** (herramientas de compilación)
### Multimedia ### Utilidades de Terminal
- yt-dlp, ffmpeg - **eza** (ls mejorado)
- tumbler, ffmpegthumbnailer - **bat** (cat mejorado)
- gst-plugins-{good,bad,ugly} - **zoxide** (cd inteligente)
- libheif, webp-pixbuf-loader - **fastfetch** (info del sistema)
- **htop**, **btop** (monitores del sistema)
- **tree** (visualización de directorios)
### Utilidades ### Multimedia y Control
- playerctl, brightnessctl, pamixer - **yt-dlp**, **ffmpeg**
- neofetch, htop, btop - **playerctl**, **brightnessctl**, **pamixer**
- tree, unzip, p7zip, unrar - **audacity**, **inkscape**
- rofi, wl-clipboard, rofimoji
### Red y Seguridad ### Red y Seguridad
- zerotier-one - **zerotier-one** (desde AUR)
- gnome-keyring, libsecret, seahorse - **gnome-keyring**, **libsecret**, **seahorse**
- lsof, net-tools - **lsof**, **net-tools**
- **teamviewer**
### Impresión ### Utilidades del Sistema
- cups, cups-pdf - **nano**, **unzip**, **tar**
- system-config-printer - **p7zip**, **unrar**
- gutenprint
- epson-inkjet-printer-escpr{,2} ### Instalaciones Adicionales
- **speedtest-cli** (vía pip)
</details> </details>
@@ -88,35 +94,42 @@ bash <(curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/oma
## 🎯 Durante la instalación ## 🎯 Durante la instalación
El script te preguntará: El script ejecuta los siguientes pasos:
1. **¿Continuar con la instalación?** (Y/n) 1. **Verificación de requerimientos** (root, Arch Linux, conexión a Internet)
2. **ZeroTier Network ID** - Tu red privada (opcional) 2. **Instalación de paquetes base** desde repositorios oficiales
3. **GNOME Keyring:** 3. **Instalación de yay** desde AUR (si no está instalado)
- Sin contraseña (más conveniente) 4. **Configuración de Docker** (servicio y permisos de usuario)
- Igual a tu contraseña de usuario (recomendado) 5. **Instalación de Oh My Zsh y plugins**
- Contraseña personalizada 6. **Configuración de .zshrc y tema Catppuccin** desde GitHub
4. **Configuración de Git** - Nombre y email (opcional) 7. **Configuración de TeamViewer** (servicio)
8. **Instalación de ZeroTier One** desde AUR (opcional)
9. **Configuración de GNOME Keyring** (opcional)
10. **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 ## 🔑 GNOME Keyring
El keyring guarda contraseñas de: El keyring guarda contraseñas de forma segura:
- Git (credential helper) - **Git** (credential helper)
- VS Code - **SSH keys** (almacenadas de forma segura)
- SSH keys - **Aplicaciones GNOME**
- Aplicaciones GNOME
### Opciones recomendadas: ### Configuración automática:
| Opción | Seguridad | Conveniencia | Recomendado para | El script configura automáticamente:
|--------|-----------|--------------|------------------| - PAM para auto-desbloqueo del keyring
| Sin contraseña | Baja | Alta | Laptop personal | - Inicio automático de gnome-keyring-daemon
| Contraseña de usuario | Alta | Alta | Uso general ⭐ | - Integración con SSH agent
| Contraseña personalizada | Alta | Media | Datos sensibles |
### Configuración post-instalación: ### Comandos útiles:
```bash ```bash
# Abrir gestor de contraseñas # Abrir gestor de contraseñas
@@ -125,10 +138,10 @@ seahorse
# Ver estado del keyring # Ver estado del keyring
gnome-keyring-daemon --version gnome-keyring-daemon --version
# Comandos de ZeroTier # Comandos de ZeroTier (aliases en .zshrc)
zt # Alias de zerotier-cli zt # Alias de sudo zerotier-cli
ztstatus # Ver redes conectadas ztstatus # Ver redes conectadas (listnetworks)
ztinfo # Info del nodo ztinfo # Info del nodo (info)
``` ```
--- ---
@@ -183,11 +196,13 @@ pipf # pip freeze > requirements.txt
```bash ```bash
ytm <URL> # Descargar audio MP3 320kbps ytm <URL> # Descargar audio MP3 320kbps
ytm "lofi beats" # Buscar y descargar ytm "lofi beats" # Buscar y descargar
ytv <URL> # Descargar video MP4 ytv <URL> # Descargar video MP4 (calidad por defecto)
ytv "tutorial" # Buscar y descargar video ytv <URL> 1080 # Descargar video en 1080p
ytv <URL> 720 # Descargar video en 720p
ytls # Listar últimos descargas
``` ```
Descargas en: `~/Videos/ytdlp/` Descargas en: `~/Videos/YouTube/{Music,Videos}/`
### NPM ### NPM
```bash ```bash
@@ -211,43 +226,6 @@ clima # Ver clima Saltillo
--- ---
## 🎨 Emoji Launcher
Presiona **SUPER + .** (tecla Windows + punto) para abrir el selector de emojis.
- Busca por nombre: "heart", "smile", "rocket"
- Navega con flechas
- Enter para copiar al portapapeles
- Compatible con Wayland/Hyprland
---
## 🖨️ Configurar Impresora Epson L4150
### Opción 1: Interfaz web (recomendado)
```bash
# Abrir en navegador
http://localhost:631
# Ir a: Administration → Add Printer
# Buscar: Epson L4150
# Seleccionar driver: Epson L4150 Series
```
### Opción 2: Herramienta gráfica
```bash
system-config-printer
```
### Conexión:
- **USB**: Detecta automáticamente
- **WiFi**: Buscar impresoras de red
- **IP**: Usar dirección IP de la impresora
---
## 🌐 ZeroTier Network ID ## 🌐 ZeroTier Network ID
Tu Network ID tiene formato: `a0cbf4b62a1234567` (16 caracteres hex) Tu Network ID tiene formato: `a0cbf4b62a1234567` (16 caracteres hex)
@@ -283,31 +261,36 @@ ztinfo
``` ```
$HOME/ $HOME/
├── .zshrc # Configuración de Zsh ├── .zshrc # Configuración de Zsh (descargado desde GitHub)
├── .zshrc.local # Config local (opcional) ├── .zshrc.local # Config local (opcional, no creado automáticamente)
├── .oh-my-zsh/ # Oh My Zsh ├── .oh-my-zsh/ # Oh My Zsh
│ └── custom/plugins/ # Plugins adicionales │ └── custom/plugins/ # Plugins adicionales
│ ├── zsh-autosuggestions/
│ └── zsh-syntax-highlighting/
├── .poshthemes/ # Temas Oh My Posh ├── .poshthemes/ # Temas Oh My Posh
│ └── catppuccin.omp.json │ └── catppuccin.omp.json # Tema Catppuccin Frappe
├── .npm-global/ # NPM global packages ├── .zsh_functions/ # Funciones personalizadas (directorio creado)
├── .zsh_functions/ # Funciones personalizadas ├── Videos/YouTube/ # Descargas de yt-dlp
├── AppImages/ # Aplicaciones AppImage │ ├── Music/ # Audios MP3
── Videos/ytdlp/ # Descargas de yt-dlp │ └── Videos/ # Videos MP4
── Projects/ # Tus proyectos ── .ssh/ # Claves SSH (si existen)
└── omarchy-setup.log # Log de instalación
``` ```
--- ---
## 🔄 Después de la instalación ## 🔄 Después de la instalación
### 1. Reiniciar sesión (IMPORTANTE) ### 1. Reiniciar sesión o terminal (IMPORTANTE)
**⚠️ REINICIO REQUERIDO** si se instalaron servicios como TeamViewer o ZeroTier.
```bash ```bash
# Cerrar sesión y volver a entrar # Cerrar y volver a abrir la terminal para usar Zsh
# Esto aplica: # O cerrar sesión y volver a entrar para aplicar:
# - Cambio de shell a Zsh # - Cambio de shell a Zsh
# - Grupos (docker, video, lp) # - Grupos (docker)
# - Permisos de brillo # - Permisos del sistema
``` ```
### 2. Verificar instalación ### 2. Verificar instalación
@@ -316,12 +299,18 @@ $HOME/
# Ver versión de Zsh # Ver versión de Zsh
zsh --version zsh --version
# Ver tema # Ver tema Oh My Posh
oh-my-posh version oh-my-posh version
# Ver ZeroTier # Verificar Docker
docker ps
# Ver ZeroTier (si se configuró)
ztstatus ztstatus
# Ver TeamViewer (si se instaló)
teamviewer info
# Actualizar sistema # Actualizar sistema
pacu pacu
``` ```
@@ -342,13 +331,17 @@ alias miproyecto="cd ~/Projects/mi-app && code ."
## 🛠️ Solución de problemas ## 🛠️ Solución de problemas
### Las teclas Fn de brillo no funcionan ### Docker no funciona sin sudo
```bash ```bash
# Verificar permisos # Verificar que estás en el grupo docker
groups # Debe incluir 'video' groups # Debe incluir 'docker'
# Reiniciar sesión si no aparece # Si no aparece, reinicia sesión o ejecuta:
newgrp docker
# Verificar acceso
docker ps
``` ```
### Git sigue pidiendo contraseña ### Git sigue pidiendo contraseña
@@ -364,44 +357,56 @@ git config --global credential.helper libsecret
# Abrir Seahorse y verificar keyring # Abrir Seahorse y verificar keyring
seahorse seahorse
# Verificar que el keyring está corriendo
pgrep -u "$USER" gnome-keyring-daemon
``` ```
### ZeroTier no conecta ### ZeroTier no conecta
```bash ```bash
# Verificar servicio
sudo systemctl status zerotier-one
# Ver logs # Ver logs
sudo journalctl -u zerotier-one -f sudo journalctl -u zerotier-one -f
# Reiniciar servicio # Reiniciar servicio
sudo systemctl restart zerotier-one sudo systemctl restart zerotier-one
# Verificar que autorizaste en https://my.zerotier.com # Verificar que autorizaste el nodo en https://my.zerotier.com
ztinfo
ztstatus
``` ```
### Emoji launcher no abre ### Oh My Posh no se muestra correctamente
```bash ```bash
# Verificar instalación # Verificar instalación
which rofimoji which oh-my-posh
oh-my-posh version
# Recargar Hyprland # Verificar que el tema existe
hyprctl reload ls ~/.poshthemes/catppuccin.omp.json
# Probar desde terminal # Verificar que tienes una Nerd Font instalada
rofimoji # (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/
``` ```
### Impresora no detectada ### El shell no cambió a Zsh
```bash ```bash
# Verificar servicio CUPS # Verificar shell actual
sudo systemctl status cups echo $SHELL
# Reiniciar CUPS # Cambiar manualmente
sudo systemctl restart cups chsh -s $(which zsh)
# Ver impresoras detectadas # Cerrar y abrir nueva terminal
lpstat -p -d
``` ```
--- ---
@@ -411,9 +416,11 @@ lpstat -p -d
- **Arch Wiki**: https://wiki.archlinux.org/ - **Arch Wiki**: https://wiki.archlinux.org/
- **Oh My Zsh**: https://ohmyz.sh/ - **Oh My Zsh**: https://ohmyz.sh/
- **Oh My Posh**: https://ohmyposh.dev/ - **Oh My Posh**: https://ohmyposh.dev/
- **Catppuccin Theme**: https://github.com/catppuccin/catppuccin
- **ZeroTier**: https://www.zerotier.com/ - **ZeroTier**: https://www.zerotier.com/
- **yt-dlp**: https://github.com/yt-dlp/yt-dlp - **yt-dlp**: https://github.com/yt-dlp/yt-dlp
- **Epson Drivers**: https://aur.archlinux.org/packages/epson-inkjet-printer-escpr - **Nerd Fonts**: https://www.nerdfonts.com/ (requerido para iconos del prompt)
- **yay AUR Helper**: https://github.com/Jguer/yay
--- ---
@@ -430,15 +437,17 @@ Si encuentras problemas:
## 📝 Changelog ## 📝 Changelog
### v1.0.0 (2025-01-21) ### v2.8.1 (2025-11-02)
- Instalación inicial de Zsh + Oh My Posh - Versión unificada con estética Catppuccin
- Google Chrome reemplaza omarchy-chromium - Instalación mejorada de paquetes con manejo de errores robusto
- Drivers Epson L4150 - **oh-my-posh** instalado desde AUR automáticamente
- ZeroTier One con configuración interactiva - Configuración `.zshrc` descargada desde GitHub
- GNOME Keyring con opciones de contraseña - Instalación de plugins Zsh mejorada
- Emoji Launcher (rofimoji) - Configuración de ZeroTier One desde AUR
- Thumbnails en Nautilus - Configuración opcional de GNOME Keyring y SSH
- Aliases y funciones útiles - **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
--- ---
@@ -456,13 +465,16 @@ MIT License - Libre de usar y modificar
--- ---
## ⭐ ¿Te gustó?
Si este script te fue útil, dale una estrella ⭐ al repo!
```bash ```bash
# Instalar en una línea # Instalar en una línea
bash <(curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/omarchy_zsh_setup/omarchy-setup.sh) bash <(curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/omarchy_zsh_setup/omarchy-setup.sh)
``` ```
🚀 **¡Disfruta tu nuevo setup de Omarchy!** ## 📝 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!**