"OH MY ZSHELL!"

NOTE: This documentation isn't finished and this project is currently under rapid development. Be cautious, information here may not be up to date.

NOTE: This fork is specifically for Archlinux and has been patched for a system-wide install; Don't attempt to install to ~/.oh-my-zsh! This project had radically diverged away from its source. While plugins should remain compatible, there is much which has changed.

Setup

oh-my-zsh should work with any recent release of zsh, the minimum recommended version is 4.3.9.

A package can be found in Archlinux's AUR. We recommend using cower to install it:

cower -dd oh-my-zsh-git

The user must have zsh set as their shell.

# chsh -s /bin/zsh <USERNAME>

The following needs to be added to the start of the user's ~/.zshrc file to activate oh-my-zshell goodness.

ZSH_THEME="arch-blue"
plugins=(archlinux sprunge git)
load_oh_my_zshell

A skeleton template can be found in /usr/share/oh-my-zsh/templates/user.zsh-template

Customization

• To enable more the plugins, customize the plugins array in your ~/.zshrc
• To change themes, change the @ZSH_THEME@ environment variable in ~/.zshrc.

If you want to override any of the default behaviour, just add a new file (ending in .zsh) into the ~/.omz/ directory. If you have many functions which go good together you can put them as a *.plugin.zsh file in the ~/.omz/plugins/ directory.

If you would like to override the functionality of a plugin distributed with oh-my-zsh, create a plugin of the same name in the ~/.omz/plugins/ directory and it will be loaded instead of the one provided one.

Resources

The refcard is pretty tasty for tips.