byobu-ulevel(1) byobu byobu-ulevel(1)

# [NAME](#NAME)

**byobu-ulevel** - helper script for notification level indicators

# [DESCRIPTION](#DESCRIPTION)

**byobu-ulevel** is a helper script that can be used to create history graphs with UTF8 characters

# [USAGE](#USAGE)

**byobu-ulevel** \[options] -c <current\_num>

**byobu-ulevel** \[options] <current\_num>

**byobu-ulevel** <current\_num>

# [OPTIONS](#OPTIONS)

-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](#EXAMPLES)

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](#NOTES)

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.

# [SEE ALSO](#SEE_ALSO)

[**byobu**(1)](/man/os/byobu/byobu.1)

[*https://byobu.org*](https://byobu.org)

# [AUTHOR](#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*.

16 Dec 2013 byobu

---

Document: byobu-ulevel(1) from byobu 7.20-r0 (Chainguard OS)
Source: https://github.com/dustinkirkland/byobu