Home

Awesome

ztheme

A small and fast theme engine for zsh.

How to install

On Arch Linux (this way, you can use pacman -R to uninstall and you don't have to manually uninstall it to update):

git clone https://github.com/SkyyySi/ztheme-git
cd ztheme-git
makepkg -sifc

On other distros:

git clone https://github.com/SkyyySi/ztheme
cd ztheme
sudo make install

Additionally, you have to add the following to your ~/.zshrc file (or /etc/zsh/zshrc to enable for all users) in order to activate ztheme:

if [ -f "/usr/share/ztheme/plugins/ztheme.plugin.zsh" ];then
	source "/usr/share/ztheme/plugins/ztheme.plugin.zsh"
fi

How to use

To change the theme, simply type ztheme prompt <theme name> into a terminal (for example: ztheme prompt agnoster ). Your theme will be applied imediatly and it will be restored when you open a new terminal. Similarly, you can turn plugins on and off by typing ztheme plugin on <plugin name> and ztheme plugin off <plugin name> respectively.

How to add your own themes

You can add them either into the user directory at $ZTHEME_USER_THEME_DIR/themes/ (set when ztheme is loaded, defaults to ~/.zsh/themes/ ), or if you want them to be usable by every user, you can put them into $ZTHEME_SYSTEM_THEME_DIR/themes/ .

Notes: