This repository contains the source code of July, a simple theme for the ZSH shell.

Here is a preview that you can check it out:

This theme can show you:

• The name of sourced virtual environments.
• Your host and user name.
• The path of the directory you are in.

In order to install and run this software properly, the following dependencies must be installed:

• ZSH: this is the shell this themes applies on.
• git: it will be used to clone this repository.

These steps are intended for users that want to perform a stand-alone install of this theme. As it does not need any extra dependency, it is the recommended option for most users.

• Clone this repository using git.

git clone --depth 1 https://github.com/skippyr/july\
                    ~/.local/share/zsh/themes/july

• Add the following source rule to your ~/.zshrc file. Ensure to not source any other theme to avoid conflicts.

source ~/.local/share/zsh/themes/july/july.zsh-theme

• Open a new ZSH session. The theme should now be installed and running.

These procedures are intended for users that want to use this theme within the OhMyZSH framework.

• Install OhMyZSH.
• Clone this repository using git to OhMyZSH's custom themes directory.

git clone --depth 1 https://github.com/skippyr/july\
                    "${ZSH_CUSTOM:-${HOME}/.oh-my-zsh/custom}/themes/july"

• Change the value of the ZSH_THEME variable in your ~/.zshrc file to use the theme.

ZSH_THEME=july/july

• Open a new ZSH session. The theme should now be installed and running.

If you need any kind of support, for instance: help with troubleshooting, have questions about it or want to give improvement suggestions, please report them by filing new issues in its issues page.

This software is under the MIT license. A copy of the license is bundled with the source code.