byobu-ulevel(1)

📦
version 7.20 · 2 versions
, in nixpkgs unstable, ubuntu stonking

✨ NAME ✨

byobu-ulevel — the lil helper script for notification level indicators, bestie 💖

💅 DESCRIPTION 💅

okay so real talk: byobu-ulevel is a helper script that you can use to create history graphs with UTF8 characters. that's it, that's the vibe. it's giving tiny-tool-big-energy 🌈

🎀 USAGE 🎀

here's how you call her, all three ways are valid, pick your fave:

byobu-ulevel  [options] -c <current_num>
byobu-ulevel  [options] <current_num>
byobu-ulevel  <current_num>

👑 OPTIONS 👑

so many options, and every single one is iconic. let's go:

  • -a — Accessibility mode: only output ASCII. (Also enabled if variable $a11y_variable set).
  • -b — Display current value as space if zero, rather than lowest value of theme.
  • -c <num> — Current value of your indicator.
  • -d — Enable debug output.
  • -e <int> — Number of decimal places to use for accessibility mode (default=$default_decimal_places).
  • -h — Show this help.
  • -i — Invert colour scheme (rating themes only).
  • -l — List available themes. If -t also specified, show all values for specified theme.
  • -m <num> — Minimum value (default=$min_default).
  • -n — Suppress output of newline character.
  • -p — Permissive mode — if current value out of bounds, set it to the nearest bound (min or max).
  • -q — Suppress messages (requires -t).
  • -r — Reverse direction of display (rating theme only).
  • -t <theme> — Name of theme (default=$theme_default).
  • -u <chars> — Specify a user theme (2 or more values).
  • -w <int> — Width of rating theme (default=$width_default).
  • -x <num> — Maximum value (default=$max_default).

🌸 EXAMPLES 🌸

this is the part where it all clicks, fr fr:

Display character representing 27% using default theme.

byobu-ulevel 27

As above.

byobu-ulevel -c 27

Example showing floating-point and negative values.

byobu-ulevel -c 1.100001 -m -5.00234 -x 2.71828 -t dice_6

Use accessibility mode to display a percentage value (rounded to nearest percentage)

byobu-ulevel -m -22.613 -x 5.00212 -c 0.10203 -a -e 0

Display value using a "rating theme" (displayed left-to-right).

byobu-ulevel -c 83 -t stars_2

Display right-to-left inverted "rating theme".

byobu-ulevel -c 60 -t diamonds_2 -ri

Display all glyphs in solid_numbers_a_10 theme.

byobu-ulevel -l -t solid_numbers_a_10

Display a user-specified rating theme 10 glyphs wide.

byobu-ulevel -c 666.321 -m -273.15 -x 1370 -u "· ☢" -w 10

A multi-element user theme (this prints e).

byobu-ulevel -c 50 -u "a b c d e f g h i j"

💀 NOTES 💀

important stuff, don't skip it bestie:

  • Arguments of type <int> denote an integer value, whereas arguments of type <num> denotes either an integer or a floating-point number.
  • The final _<number> in a theme name denotes the number of glyphs in it.
  • "Rating themes" are those with only 2 values.
  • The <chars> argument to -u must contain space-delimited characters.
not me needing to remind you that <int> and <num> are literally different things 🙈 get it right and you eat, get it wrong and… well. 💅

🫶 SEE ALSO 🫶

💜 AUTHOR 💜

This utility was written by James Hunt <james.hunt@canonical.com>, and this manpage was written by Dustin Kirkland <kirkland@byobu.org> for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document and the utility under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

The complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL on Debian/Ubuntu systems, or in /usr/share/doc/fedora-release-*/GPL on Fedora systems, or on the web at http://www.gnu.org/licenses/gpl.txt.

and that's the whole page, babe 💖 brought to you by the byobu girlies, dated 16 Dec 2013 — yes it's old, no we don't care, she's still slaying ✨🦋 periodt 🌸

📦 where this page comes from