https://github.com/zimfw/sorin
A fork of sorin's prompt theme.
https://github.com/zimfw/sorin
prompt sorin theme zim zimfw zsh zsh-plugin zsh-plugins zsh-prompt
Last synced: about 2 months ago
JSON representation
A fork of sorin's prompt theme.
- Host: GitHub
- URL: https://github.com/zimfw/sorin
- Owner: zimfw
- License: mit
- Created: 2020-05-19T02:16:28.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-29T21:19:57.000Z (4 months ago)
- Last Synced: 2025-04-13T12:12:57.751Z (about 2 months ago)
- Topics: prompt, sorin, theme, zim, zimfw, zsh, zsh-plugin, zsh-plugins, zsh-prompt
- Language: Shell
- Homepage:
- Size: 10.7 KB
- Stars: 7
- Watchers: 1
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
sorin
=====
A fork of the [sorin] theme.
What does it show?
------------------
* On the left:
* `username@hostname` when in a 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 position or
commit short hash.
* `⬆` and/or `⬇` when there are commits ahead and/or behind of remote, respectively.
* `✭` when there are stashed states.
* `✚` when there are indexed files.
* `✱` when there are unindexed 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
| ------------ | ------------------------ | --------------
| action | Special action name | `%F{default}:%F{1}%s`
| ahead | Ahead of remote | ` %F{5}⬆`
| behind | Behind remote | ` %F{5}⬇`
| branch | Branch name | ` %F{2}%b`
| commit | Commit short hash | ` %F{3}%c`
| indexed | Indexed files | ` %F{2}✚`
| unindexed | Unindexed files | ` %F{4}✱`
| position | Commits from nearest tag | ` %F{5}%p`
| stashed | Stashed states | ` %F{6}✭`
| untracked | Untracked files | ` %F{default}◼`
Use the following command to override a git-info context format:
zstyle ':zim:git-info:' format ''
For detailed information about these and other git-info settings, check the
[git-info documentation].
These advanced settings must be overridden after the theme is initialized.
Requirements
------------
Requires Zim's [prompt-pwd] module to show the current working directory, and
[git-info] to show git information.
[sorin]: https://github.com/sorin-ionescu/prezto/blob/master/modules/prompt/functions/prompt_sorin_setup
[venv]: https://docs.python.org/3/library/venv.html
['detached HEAD' state]: https://git-scm.com/docs/git-checkout#_detached_head
[prompt-pwd module settings]: https://github.com/zimfw/prompt-pwd/blob/master/README.md#settings
[git-info documentation]: https://github.com/zimfw/git-info/blob/master/README.md#settings
[prompt-pwd]: https://github.com/zimfw/prompt-pwd
[git-info]: https://github.com/zimfw/git-info