dbar(1)

✨ dbar(1) ✨

okay so bestie, welcome to the User Commands section of the manual, page dbar(1). sit down, grab a boba, we're doing progress bars today 🫶

---

🌸 NAME 🌸

dbar — it's an ASCII progresbar 💅 (yes, that's the spelling in the source, we are not discussing it, the bar itself is iconic regardless)

---

🎀 SYNOPSIS 🎀

echo <percentage> | dbar [options] <indicator text>

literally just pipe a number in and watch the little bar go brrr ✨

---

💖 DESCRIPTION 💖

so here's the tea: dbar lets you define static 0% and 100% marks, or you can define those marks dynamically at runtime. and get this — static and dynamic marks can be mixed, no cap. in that case, the value you specify at runtime wins, it has higher priority, main character energy 👑

you can specify ranges of numbers, negative, positive, or ranges with a negative min value and a positive max value. all of it. we contain multitudes 🦋

and the best part: all numbers are treated as double precision floating point, meaning the input is NOT limited to integers. decimals welcome, they're invited to the party 💜

---

✨ OPTIONS ✨

• -l — the label to be prepended to the bar (default: "" ). your little name tag for the bar 🎀
• -nonl — no new line, i.e. don't put '\n' at the end of the bar (default: do print "\n"). use this when you want the bar to stay on the same line and vibe with whatever comes next 🫶
• -max — the value to be considered 100% (default: 100). the ceiling, the limit, the final boss 🧚
• -min — the value to be considered 0% (default: 0). the floor, the starting line, the "we begin" 💅
• -s — the symbol representing the percentage value in the meter (default: "="). swap it out if = isn't your aesthetic ✨
• -w — number of charcaters to be considered 100% in the meter (default: 25). that's how wide the whole thing stretches, adjust to taste 🌈

---

🍓 EXAMPLES 🍓

static 100% mark or single value input 🌸

echo 25 | dbar -max 100 -l text

Output: text  25% [======                   ]

look at her go. text, then 25%, then the bar doing its little thing 💖

if your 100% mark changes dynamically, or 2-values input 💫

echo "50 150" | dbar
      |   |
      |   |__ max value
      |
      |__ value to display

Output: 33% [========                 ]

so you feed it two numbers, and the diagram above is literally telling you which one is which. first one = the value to display, second one = the max value. iykyk 🧚

if your value range is not between [0, maxval], or 3-values input 👑

echo "50 -25 150" | dbar
      |   |  |
      |   |  |__ max value 100% mark
      |   |
      |   |_____ min value 0% mark
      |
      |________ value to display

Output: 43% [===========              ]

three numbers, three jobs. value to display, then the min value (0% mark), then the max value (100% mark). and now your range can go negative, slay 💅

multiple runs 🔥

for i in 2 20 50 75 80; do echo $i; sleep 1; done | dbar | dzen2

Output: Find out yourself.

ngl the manual literally said find out yourself and honestly? respect. run it, bestie, it's giving suspense 😭

---

🌈 ENVIRONMENT 🌈

None. nothing here. empty. the void. 💀

---

🦋 FILES 🦋

None. also nothing. she's self-contained, she doesn't need files, she's low maintenance 🫶

---

👑 SEE ALSO 👑

• dzen2(1)

---

💜 AUTHORS 💜

the program itself was written by Robert Manea <rob.manea@gmail.com> — thank you for this icon, king 🫡

this manual page was written by Jari Aalto <jari.aalto@cante.net> for the Debian GNU system (but may be used by others, sharing is caring). released under license GNU GPL version 2 or (at your option) any later version. for more information about the license, visit <http://www.gnu.org/copyleft/gpl.html> 💖

---

okay that's the whole page, you're basically a dbar expert now, go forth and pipe things 🌟

dbar · version/date stamp: 2022-06-04 · page dbar(1) — mwah, take care bestie 💅✨