LIQUIDPROMPT(1)

💖 LIQUIDPROMPT 💖

okay bestie, gather round, because this is the manual page for liquidprompt — and it's giving full-featured & carefully designed adaptive prompt for bash & zsh. yes, the whole thing. no cap. 🦋

---

✨ NAME ✨

liquidprompt — A full-featured & carefully designed adaptive prompt for bash & zsh

---

🌸 DESCRIPTION 🌸

Liquid Prompt hands you a nicely displayed prompt packed with useful info exactly when you need it. It shows you what you need, when you need it. And the way it does that? You'll literally notice what changes when it changes, which saves you time and saves you frustration. periodt. 💅

And the best part — you can run it with your fave shell, bash(1) or zsh(1). main character energy either way. 👑

---

🎀 ACTIVATION 🎀

So here's the tea: the liquidprompt package has no way to know which users you want this prompt active for. So a little script, liquidprompt_activate, ships with it to make activation easy. 🧚

Running it sets the required environment, like this:

• The files ~/.bashrc and/or ~/.zshrc get modified so they load liquidprompt at startup.
• If no previous ~/.config/liquidpromptrc file exists, it gets created. ✨

So to get liquidprompt working, simply run:

user@debian:~$ liquidprompt_activate
user@debian:~$ source ~/.bashrc

⚠️ heads up bestie: multiple invocations of the liquidprompt_activate command may pollute ~/.bashrc and/or ~/.zshrc files. 😭 like, run it once, okay? don't spam it.

---

🔥 FUNCTIONS 🔥

Once liquidprompt has been loaded, you get 4 new commands available (which are shell functions actually, iykyk). 💜

• liquidprompt_tag tag — tag the current shell liquidprompt with tag.
• liquidprompt_OFF — use an empty prompt, just the $ mark.
• liquidprompt_off — turn off liquidprompt for this shell.
• liquidprompt_on — turn on liquidprompt for this shell.

(and yes, OFF and off are two completely different things, she contains multitudes 🌈)

---

⭐ CONFIGURATION ⭐

liquidprompt is highly configurable. there are plenty of options regarding style, performance, VCS, et all. 👑

Please take a look at the included README file at /usr/share/doc/liquidprompt/ and the file ~/.config/liquidpromptrc as well. go read them, they're iconic, trust. 🍓

---

🫶 SEE ALSO 🫶

https://liquidprompt.readthedocs.io/, bash(1), zsh(1)

---

💀 ABOUT 💀

liquidprompt was originally developed by nojhan <nojhan@nojhan.net>. 🎀

Visit the source code at https://github.com/nojhan/liquidprompt.

This manpage was written by Arturo Borrero Gonzalez <arturo@debian.org> for the Debian GNU/Linux distribution (but it may be used by others). 🦋

---

okay that's the whole thing, you're officially educated 💖 this little beauty is dated Dec 16, 2020 — genuinely vintage in internet years, and still absolutely slaying. go forth and prompt, bestie. 💅✨