Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nojhan/lp-pureship
Themes for Liquid Prompt, emulating Spaceship/Starship and Pure prompts.
https://github.com/nojhan/lp-pureship
bash liquidprompt liquidprompt-theme prompt prompt-toolkit prompt-tuning pure shell spaceship starship zsh
Last synced: 28 days ago
JSON representation
Themes for Liquid Prompt, emulating Spaceship/Starship and Pure prompts.
- Host: GitHub
- URL: https://github.com/nojhan/lp-pureship
- Owner: nojhan
- License: agpl-3.0
- Created: 2022-10-09T11:35:24.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-30T08:26:31.000Z (about 1 year ago)
- Last Synced: 2023-10-30T09:30:06.391Z (about 1 year ago)
- Topics: bash, liquidprompt, liquidprompt-theme, prompt, prompt-toolkit, prompt-tuning, pure, shell, spaceship, starship, zsh
- Homepage:
- Size: 86.9 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Pureship — a set of Liquid Prompt Themes
========================================
Pureship is a set of 3 themes for [Liquid Prompt](https://github.com/nojhan/liquidprompt).
All of them are emulating the design of other prompt systems,
namely [Starship](https://starship.rs) (and [Spaceship](https://spaceship-prompt.sh),
which share the same design), and [Pure](https://github.com/sindresorhus/pure).
Preview
-------
Spaceship, Starship and Pure all follow the same design principles,
so they all look very similar: that is a two-line prompt,
with foreground-colored sections, separated by preposition words.
The *starship* theme only includes features that have a counterpart in Liquid Prompt.
Whether the *liquidship* integrates the additional features of Liquid Prompt,
plus some changes to have a better (IMHO) ergonomy.
The *pure* theme is almost complete, given that pure targets a very limited subset of features.
Install
-------
Just download this repository somewhere, source the chosen theme file and activate it,
all from your shell configuration file.
For example (just use `~/.zshrc` instead of `~/.bashrc`, if you use Zsh and not Bash):
```sh
git clone https://github.com/nojhan/lp-neon.git
echo '# Use Liquid Prompt only if in an interactive shell
if [[ $- == *i* ]]; then
# Use Liquid Prompt
source ~/.liquidprompt
# Select the right file below, depending on the theme you want:
if [[ -f ~/lp-pureship/liquidship.theme ]] ; then
source ~/lp-pureship/liquidship.theme && lp_theme liquidship
fi
fi' >> ~/.bashrc
```
Rationale
---------
All of those themes are two lines, with the majority of information on the top one,
and sections separated by proposition words.
They are thus quite close to the Liquid Prompt default theme.
The main differences are that \*ship themes heavily rely on icons
and tends to be designed as a sequence of icon-name sections.
Liquid Prompt is rather designed as an *integrated* set of information,
and thus tends to be more compact (and have a better user experience, IMHO).
One of the main difference also rely on the fact that \*ship prompts
are themed through a domain-specific descriptive language (using a dialect of JSON),
whether Liquid Prompt allows for using sections tags within a Turing-complete language (the Shell).
Concretely, Liquid Prompt allow for far more degrees of freedom in theming.
You can easily see the result by browsing the diverse set of
[Liquid Prompt's themes](https://github.com/nojhan/liquidprompt/wiki/Themes),
against the very homogeneous [Starship ones](https://starship.rs/presets/#nerd-font-symbols).
Globally, \*ship prompts thus tend to be just a sequenced collection of information.
They also tend to not pay much attention to the location of their sections,
hence having semantically close information (for instance, containers configuration),
spread everywhere.
They also display minor information on the second ("prompt") line, and important one
on the top line, which does not help the user notice important stuff fast.
The *liquidship* theme tries to correct this kind of ergonomic errors (to some extent),
while keeping the \*ship global design approach.
Liquidship theme
================
If there is nothing special about the current context:
If you are running some command in a Git repository:
When Liquid Prompt is displaying a lot of things, it may look like this:
Starship theme
==============
If there is nothing special about the current context:
If you are running some command in a Git repository:
When Liquid Prompt is displaying a lot of things, it may look like this:
Pure theme
==========
If there is nothing special about the current context:
If you are running some command in a Git repository:
When Liquid Prompt is displaying a lot of things, it may look like this:
