/lildragon

A simple theme for the ZSH shell that is decorated by a dragon

Primary LanguageShellMIT LicenseMIT

Lildragon

About

This repository contains the source code of Lildragon, a simple theme for the ZSH shell that is decorated by a dragon.

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:

  • The name of sourced virtual environments.
  • Your user name.
  • The path of the directory you are in, abbreviating parent directory names by their initials.
  • 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 and an emojis font: they provide 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/lildragon\
                    ~/.local/share/zsh/themes/lildragon
  • Add the following source rule to your ~/.zshrc file. Ensure to not source any other theme to avoid conflicts.
source ~/.local/share/zsh/themes/lildragon/lildragon.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/lildragon\
                    "${ZSH_CUSTOM:-${HOME}/.oh-my-zsh/custom}/themes/lildragon"
  • Change the value of the ZSH_THEME variable in your ~/.zshrc file to use the theme.
ZSH_THEME=lildragon/lildragon
  • 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.