Oh My Zsh es un código abierto, marco impulsado por la comunidad para la gestión de su configuración zsh.

Suena aburrido. Intentémoslo de nuevo.

Oh My Zsh no te convertirá en un desarrollador 10x… pero puede que te sientas como uno.

Una vez instalado, tu shell de terminal se convertirá en la comidilla de la ciudad o te devolverá tu dinero. Con cada pulsación en su símbolo del sistema, aprovechará los cientos de potentes plugins y hermosos temas. Los desconocidos se acercarán a ti en los cafés y te preguntarán: «¡es increíble! ¿eres una especie de genio?»

Por fin, empezarás a recibir el tipo de atención que siempre has sentido que mereces. …O tal vez utilices el tiempo que estás ahorrando para empezar a usar el hilo dental más a menudo. 😬

Para saber más, visita ohmyz.sh, sigue a @ohmyzsh en Twitter y únete a nosotros en Discord.

Cómo empezar

Requisitos previos

• Un sistema operativo tipo Unix: macOS, Linux, BSD. En Windows: Se prefiere WSL2, pero cygwin o msys también funcionan en la mayoría de los casos.
• Zsh debe estar instalado (v4.3.9 o más reciente está bien, pero preferimos 5.0.8 y más reciente). Si no está preinstalado (ejecute zsh --version para confirmarlo), consulte las siguientes instrucciones de la wiki aquí: Instalación de ZSH
• curl o wget debe ser instalado
• git debe ser instalado (recomendado v2.4.11 o superior)

Instalación básica

Oh Mi Zsh se instala ejecutando uno de los siguientes comandos en su terminal. Puedes instalarlo a través de la línea de comandos con curl, wget u otra herramienta similar.

Inspección manual

Es una buena idea inspeccionar el script de instalación de proyectos que aún no conoces. Puedes hacerlo descargando el script de instalación primero, mirándolo para que todo parezca normal, y luego ejecutándolo:

wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.shsh install.sh

Usando Oh My Zsh

Plugins

Oh My Zsh viene con un montón de plugins para que los aproveches. Puedes echar un vistazo en el directorio de plugins y/o en el wiki para ver lo que está disponible actualmente.

Habilitando Plugins

Una vez que encuentres un plugin (o varios) que te gustaría usar con Oh My Zsh, necesitarás habilitarlos en el archivo .zshrc. Encontrarás el archivo zshrc en tu directorio $HOME. Ábrelo con tu editor de texto favorito y verás un lugar para listar todos los plugins que quieras cargar.

vi ~/.zshrc

Por ejemplo, esto podría empezar a verse así:

plugins=( git bundler dotenv osx rake rbenv ruby)

Nota que los plugins están separados por espacios en blanco (espacios, tabulaciones, nuevas líneas…). No use comas entre ellos o se romperá.

Usando plugins

Cada plugin incluye un README, documentándolo. Este README debería mostrar los alias (si el plugin añade alguno) y las bondades extra que se incluyen en ese plugin en particular.

Temas

Lo admitimos. Al principio del mundo de Oh My Zsh, puede que nos hayamos vuelto un poco demasiado felices con los temas. Tenemos más de ciento cincuenta temas ahora agrupados. La mayoría de ellos tienen capturas de pantalla en el wiki (¡Estamos trabajando en la actualización de esto!).

Seleccionando un tema

El tema de Robby es el predeterminado. No es el más elegante. No es el más sencillo. Es simplemente el correcto (para él).

Una vez que encuentre un tema que le gustaría usar, necesitará editar el archivo ~/.zshrc. Verá una variable de entorno (todo en mayúsculas) allí que se parece a:

ZSH_THEME="robbyrussell"

Para utilizar un tema diferente, simplemente cambie el valor para que coincida con el nombre de su tema deseado. Por ejemplo:

ZSH_THEME="agnoster" # (this is one of the fancy ones)# see https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#agnoster

Nota: muchos temas requieren la instalación de las fuentes Powerline para que se puedan representar correctamente.

Abra una nueva ventana de terminal y su indicador debería ser algo así:

En caso de que no encuentre un tema adecuado para sus necesidades, por favor, eche un vistazo a la wiki para más de ellos.

Si te sientes con ganas, puedes dejar que el ordenador seleccione uno al azar por ti cada vez que abras una nueva ventana de terminal.

ZSH_THEME="random" # (...please let it be pie... please be some pie..)

Y si quieres elegir un tema al azar de una lista de tus temas favoritos:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Si sólo sabes qué temas no te gustan, puedes añadirlos igualmente a una lista de ignorados:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Si tienes más preguntas o problemas, puede que encuentres una solución en nuestras FAQ.

Temas Avanzados

Si eres de los que les gusta ensuciarse las manos, estas secciones pueden ser de interés.

Instalación Avanzada

Algunos usuarios pueden querer instalar manualmente Oh My Zsh, o cambiar la ruta por defecto u otras configuraciones que el instalador acepta (estas configuraciones también están documentadas en la parte superior del script de instalación).

Directorio personalizado

La ubicación por defecto es ~/.oh-my-zsh (oculta en su directorio personal, puede acceder a ella con cd ~/.oh-my-zsh)

Si desea cambiar el directorio de instalación con la variable de entorno ZSH, ya sea ejecutandoexport ZSH=/your/path antes de la instalación, o estableciéndola antes del final de la tubería de instalación de esta manera:

ZSH="$HOME/.dotfiles/oh-my-zsh" sh install.sh

Instalación desatendida

Si está ejecutando el script de instalación Oh My Zsh como parte de una instalación automatizada, puede pasar la bandera --unattended al script install.sh. Esto tendrá el efecto de no tratar de cambiar el shell por defecto, y también no se ejecutará zsh cuando la instalación haya terminado.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended

Instalando desde un repositorio forked

El script de instalación también acepta estas variables para permitir la instalación de un repositorio diferente:

• REPO (por defecto: ohmyzsh/ohmyzsh): esto toma la forma de owner/repository. Si establece esta variable, el instalador buscará un repositorio en

• REMOTE (por defecto: ): esta es la URL completa del repositorio git. Puedes usar esta configuración si quieres instalar desde un fork que no está en GitHub (GitLab,Bitbucket…) o si quieres clonar con SSH en lugar de HTTPS ([email protected]:user/project.git).

  NOTA: es incompatible con establecer la variable REPO. Este ajuste tendrá prioridad.

• BRANCH (por defecto: master): puede utilizar este ajuste si quiere cambiar la rama por defecto para que sea revisada al clonar el repositorio. Esto puede ser útil para probar un Pull Request, o si quiere utilizar una rama diferente a master.

Por ejemplo:

REPO=apjanke/oh-my-zsh BRANCH=edge sh install.sh

Instalación manual

1. Clone el repositorio

git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh

2. Opcionalmente, haga una copia de seguridad de su archivo ~/.zshrc existente

cp ~/.zshrc ~/.zshrc.orig

3. Cree un nuevo archivo de configuración zsh

Puede crear un nuevo archivo de configuración zsh copiando la plantilla que hemos incluido para usted.

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

4. Cambia tu shell por defecto

chsh -s $(which zsh)

Debes salir de tu sesión de usuario y volver a entrar para ver este cambio.

5. Inicialice su nueva configuración de zsh

Una vez que abra una nueva ventana de terminal, debería cargar zsh con la configuración de Oh My Zsh.

Problemas de instalación

Si tiene algún contratiempo al instalar, aquí hay algunas soluciones comunes.

• Es posible que tenga que modificar su PATH en ~/.zshrc si no es capaz de encontrar algunos comandos después de cambiar a oh-my-zsh.
• Si instaló manualmente o cambió la ubicación de instalación, compruebe la variable de entorno ZSH en~/.zshrc.

Plugins y temas personalizados

Si quieres anular alguno de los comportamientos por defecto, sólo tienes que añadir un nuevo archivo (que termine en .zsh) en el directorio custom/.

Si tienes muchas funciones que van bien juntas, puedes ponerlas como un archivo XYZ.plugin.zsh en el directorio custom/plugins/ y luego activar este plugin.

Si quieres anular la funcionalidad de un plugin distribuido con Oh My Zsh, crea un plugin del mismo nombre en el directorio custom/plugins/ y se cargará en lugar del que está en plugins/.

Obtener actualizaciones

Por defecto, se te pedirá que compruebes si hay actualizaciones cada pocas semanas. Si desea que oh-my-zsh se actualice automáticamente sin avisarle, configure lo siguiente en su ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Para desactivar las actualizaciones automáticas, configure lo siguiente en su ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Actualizaciones manuales

Si desea actualizar en cualquier momento (¿quizás alguien acaba de lanzar un nuevo plugin y no quiere esperar una semana?) sólo tienes que ejecutar:

omz update

¡Magic! 🎉

Desinstalar Oh My Zsh

Oh My Zsh no es para todos. Lo echaremos de menos, pero queremos que sea una ruptura fácil.

Si quieres desinstalar oh-my-zsh, simplemente ejecuta uninstall_oh_my_zsh desde la línea de comandos. Se eliminará a sí mismo y revertirá tu configuración anterior de bash o zsh.

¿Cómo contribuyo a Oh My Zsh?

Antes de participar en nuestra encantadora comunidad, por favor lee el código de conducta.

Estoy lejos de ser un experto en Zsh y sospecho que hay muchas maneras de mejorar – si tienes ideas sobre cómo hacer la configuración más fácil de mantener (y más rápido), no dudes en hacer un fork y enviar pull requests!

También necesitamos gente para probar los pull-requests. Así que eche un vistazo a los temas abiertos y ayude en lo que pueda.

Vea Contribuyendo para más detalles.

NO nos envíe temas

Tenemos (más que) suficientes temas por el momento. Por favor, añade tu tema a la página wiki de temas externos.

Colaboradores

Oh My Zsh tiene una vibrante comunidad de usuarios felices y contribuyentes encantadores. Sin todo el tiempo y la ayuda de nuestros colaboradores, no sería tan impresionante.

¡Muchas gracias!

Síguenos

Estamos en las redes sociales:

• @ohmyzsh en Twitter. Deberías seguirlo.
• FaceBook pokeanos.
• Instagram etiquétanos en tu post mostrando Oh My Zsh!
• Discord para chatear con nosotros!

Merchandise

Tenemos pegatinas, camisetas y tazas de café disponibles para que muestres tu amor por Oh My Zsh. De nuevo, ¡te convertirás en la comidilla de la ciudad!

Licencia

Oh My Zsh está publicado bajo la licencia MIT.

Acerca de Planet Argon