/simpalt

An information-rich-small-footprint theme for zsh based on agnoster

Primary LanguageShellMIT LicenseMIT

Simpalt

A ZSH theme based on agnoster with focus on screen real estate.

Demo

Demo

How to use it

Software Requirement

Supported frameworks

Initial setup

$ brew install zsh
$ chsh -s $(which zsh)

Installing the theme

Using ZGen

Add the following to your .zshrc

if ! zgen saved; then
  ...
  zgen load m-lima/simpalt simpalt.zsh-theme
  ...
  zgen save
fi

Using ZGen with Prezto

Add the following to your .zshrc

if ! zgen saved; then
  zgen prezto
  zgen prezto prompt theme 'simpalt'
  ...
  zgen load m-lima/simpalt
  ...
  zgen save
fi

Using ZPlug

Add the following to your .zshrc

zplug "m-lima/simpalt", as:theme

Using Oh My ZSH

Download the theme

$ cd ~/.oh-my-zsh/custom
$ git clone https://github.com/m-lima/simpalt

Add the following to your .zshrc

ZSH_THEME="simpalt"

Using vanilla ZSH

Download the theme

$ cd <whereever_you want_to_install>
$ git clone https://github.com/m-lima/simpalt

Add the following to your .zshrc

source <whereever_you want_to_install>/simpalt.zsh-theme

Options

SIMPALT_SMALL
Controls the presentation of the prompt

If set to anything, the prompt will be presented in compact mode; otherwise, the full prompt will be presented.

SIMPALT_PROMPT_SEGMENTS
Set the prompt segments to be presented

This array will set all segments that compose the prompt.

SIMPALT_MAIN_BRANCHES
Set the branches that do not require full name

When in a git repository, if the current branch is present in this list, it's name will be omitted.

Available segments:

  • prompt_aws
  • prompt_status
  • prompt_context
  • prompt_virtualenv
  • prompt_dir prompt_git

Suggested setup

You can enable quick switch between compact and full mode by registering something similar to the following in your .zshrc:

ts() { [ $SIMPALT_SMALL ] && unset SIMPALT_SMALL || SIMPALT_SMALL=1 }

Then, just use the ts command to swtich between prompt styles