---
name: "byobu-ulevel"
section: "1"
platform: "linux"
package: "byobu"
version: "5.133-1.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/byobu-ulevel"
---

# byobu-ulevel(1)

helper script for notification level indicators

## NAME

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

## DESCRIPTION

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

## USAGE

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

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

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

## 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          : Supress 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

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

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

[**byobu**(1)](/byobu/1.md)

- *http://byobu.org*

  ## 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*.