Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skippyr/lildragon
A simple theme for the ZSH shell that is decorated by a dragon
https://github.com/skippyr/lildragon
cli command-line design oh-my-zsh-theme productivity prompt script shell shell-script theme zsh zsh-script zsh-theme
Last synced: about 1 month ago
JSON representation
A simple theme for the ZSH shell that is decorated by a dragon
- Host: GitHub
- URL: https://github.com/skippyr/lildragon
- Owner: skippyr
- License: mit
- Archived: true
- Created: 2023-08-06T23:42:15.000Z (10 months ago)
- Default Branch: root
- Last Pushed: 2023-08-29T16:48:00.000Z (9 months ago)
- Last Synced: 2024-01-27T12:11:05.968Z (4 months ago)
- Topics: cli, command-line, design, oh-my-zsh-theme, productivity, prompt, script, shell, shell-script, theme, zsh, zsh-script, zsh-theme
- Language: Shell
- Homepage:
- Size: 271 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-zsh-plugins - lildragon - Dragon-themed. Includes decorators for `git` status, current directory & username. Requires a font with emoji glyphs. (Themes / ZSH on Windows)
- fucking-awesome-zsh-plugins - lildragon - Dragon-themed. Includes decorators for `git` status, current directory & username. Requires a font with emoji glyphs. (Themes / ZSH on Windows)
README
# 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](https://www.nerdfonts.com/font-downloads) and [an emojis font](https://fonts.google.com/noto/specimen/Noto+Emoji): 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`.
```bash
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.
```bash
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](https://github.com/ohmyzsh/ohmyzsh).
- Clone this repository using `git` to OhMyZSH's custom themes directory.
```bash
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.
```bash
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](https://github.com/skippyr/lildragon/issues).
## Copyright
This software is under the MIT license. A copy of the license is bundled with the source code.