Astral

About

This repository contains the source code of Astral, a theme for the ZSH shell that is decorated by chevrons.

Here is a preview that you can check it out:

Note

This theme uses the terminal emulator's colors, so they may look different in your setup when compared to the preview.

Features

This theme can show you:

• Your host and user name.
• The name of sourced virtual environments.
• The name of the directory you are in.
• When inside a Git repository, the active branch and if it is dirty.

Installation

Dependencies

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 both clone this repository and also to obtain info about your Git repositories to show in the prompt.
• A Nerd Font's font: it provides the pretty symbols used in the prompt.

Stand-alone Procedures (recommended for most users)

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/astral\
                    ~/.local/share/zsh/themes/astral

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

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

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

OhMyZSH Procedures

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/astral\
                    "${ZSH_CUSTOM:-${HOME}/.oh-my-zsh/custom}/themes/astral"

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

ZSH_THEME=astral/astral

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

Support

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.

Copyright

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