sorin

A fork of the sorin theme.

What does it show?

• On the left:
  • username@hostname when in an SSH session.
  • Working directory.
  • # when you're root.
  • Keymap indicator.
• On the right:
  • Python venv indicator.
  • ✘ when there was an error.
  • V when in a vim terminal.
  • Git information when you are in a git repo:
    • Current branch name. When in 'detached HEAD' state, the name of tag that contains current commit or the commit short hash.
    • Git action, when there's an operation in progress.
    • ⬆ and/or ⬇ when there are commits ahead and/or behind of remote, respectively.
    • ✭ when there are stashed states.
    • ✚ when there are indexed added or modified files.
    • ✖ when there are indexed deleted files.
    • ➜ when there are indexed renamed files.
    • ✱ when there are unindexed files.
    • ═ when there are unmerged files.
    • ◼ when there are untracked files.

Advanced settings

You can customize how the current working directory is shown with the prompt-pwd module settings.

The git indicators can be customized by changing the following git-info module context formats:

Context name	Description	Default format
branch	Branch name	%F{2}%b
position	Tag near current commit	%F{5}%p
commit	Commit short hash	%F{3}%c
action	Special action name	%f:%F{1}%s
ahead	Ahead of remote	%F{5}⬆
behind	Behind remote	%F{5}⬇
stashed	Stashed states	%F{6}✭
indexed	Indexed added or modified files	%F{2}✚
index-deleted	Indexed deleted files	%F{1}✖
index-renamed	Indexed renamed files	%F{5}➜
unindexed	Unindexed files	%F{4}✱
unmerged	Unmerged files	%F{3}═
untracked	Untracked files	%F{default}◼

Use the following command to override a git-info context format:

zstyle ':zim:git-info:<context_name>' format '<new_format>'

For detailed information about these and other git-info settings, check the git-info documentation.

These advanced settings must be defined at the bottom of your ~/.zshrc, after the modules are initialized with source ${ZIM_HOME}/init.zsh, in order to override the theme defaults.

Requirements

Requires Zim Framework's prompt-pwd module to show the current working directory, and git-info to show git information.