Awesome

❡ About

A theme for the zsh shell for Linux that is decorated by chess pieces.

Features

It displays:

• If you are the root user, as the pawn will become a queen.
• The exit code of failed commands.
• The name of the active Python virtual environment, if you have sourced one.
• The path of the directory you are in with parent directory names abbreviated by their initials.
• The active branch and if it is dirty, when inside of a git repository.

❡ Install

Dependencies

The following dependencies must be installed before installing it:

• git: it will be used to clone this repository.
• Noto Sans, Nerd Font Symbols: these fonts provide the pretty symbols used by the theme.

Procedures

Manual Procedures

If you want to install this theme without a plugin manager or for a specific framework, using a terminal, follow these steps:

• Clone this repository using git:

git clone --depth 1 "~/.config/zsh/themes/checkmate";

• Source the file checkmate.zsh-theme that is inside of the repository you just cloned in your ~/.zshrc configuration file:

source "~/.config/zsh/themes/checkmate/checkmate.zsh-theme";

• Reopen zsh.

Procedures For OhMyZSH

If you want to install and use this theme with the ohmyzsh framework, using a terminal, follow these steps:

• Clone this repository using git:

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

• Apply the theme in your ~/.zshrc configuration file by setting the ZSH_THEME variable:

ZSH_THEME="checkmate/checkmate";

• Reopen zsh.

Procedures For Antidote

If you want to install this theme with the antidote plugin manager, using a terminal, follow these steps:

• Add this repository to your plugins file, usually ~/.zsh_plugins.txt.

skippyr/checkmate

• Use antidote to load your plugins.

antidote load "~/.zsh_plugins.txt";

❡ Help

If you need help related to this project, open a new issue in its issues pages or send me an e-mail describing what is going on.

❡ Contributing

This project is open to review and possibly accept contributions, specially fixes and suggestions. If you are interested, send your contribution to its pull requests page or to my e-mail.

By contributing to this project, you agree to license your work under the same license that the project uses.

❡ License

This is free software licensed under the MIT License that comes WITH NO WARRANTY. Refer to the LICENSE file that comes in its source code for license and copyright details.