byobu-ulevel(1)

1byobu-ulevel(1)                      byobu                     byobu-ulevel(1)
2
3
4

NAME

6       byobu-ulevel  - helper script for notification level indicators
7
8

DESCRIPTION

10       byobu-ulevel  is  a  helper  script  that can be used to create history
11       graphs with UTF8 characters
12
13

USAGE

15       byobu-ulevel  [options] -c <current_num>
16
17       byobu-ulevel  [options] <current_num>
18
19       byobu-ulevel  <current_num>
20
21

OPTIONS

23        -a          : Accessibility mode: only output ASCII.  (Also enabled if
24       variable '$a11y_variable' set).
25        -b          : Display current value as space if zero, rather than low‐
26       est 'value' of theme.
27        -c <num>    : Current value of your indicator.
28        -d          : Enable debug output.
29        -e <int>    : Number of decimal places to use for  accessibility  mode
30       (default=$default_decimal_places).
31        -h          : Show this help.
32        -i          : Invert colour scheme (rating themes only).
33        -l           : List available themes. If '-t' also specified, show all
34       values for specified theme.
35        -m <num>    : Minimum value (default=$min_default).
36        -n          : Supress output of newline character.
37        -p          : Permissive mode - if current value out of bounds, set it
38       to the nearest bound (min or max).
39        -q          : Suppress messages (requires '-t').
40        -r          : Reverse 'direction' of display (rating theme only).
41        -t <theme>  : Name of theme (default=$theme_default).
42        -u <chars>  : Specify a user theme (2 or more values).
43        -w <int>    : Width of rating theme (default=$width_default).
44        -x <num>    : Maximum value (default=$max_default).
45
46

EXAMPLES

48       Display character representing 27% using default theme.
49         byobu-ulevel 27
50
51       As above.
52         byobu-ulevel -c 27
53
54       Example showing floating-point and negative values.
55         byobu-ulevel -c 1.100001 -m -5.00234 -x 2.71828 -t dice_6
56
57       Use  accessibility mode to display a percentage value (rounded to near‐
58       est percentage)
59         byobu-ulevel -m -22.613 -x 5.00212 -c 0.10203 -a -e 0
60
61       Display value using a "rating theme" (displayed left-to-right).
62         byobu-ulevel -c 83 -t stars_2
63
64       Display right-to-left inverted "rating theme".
65         byobu-ulevel -c 60 -t diamonds_2 -ri
66
67       Display all glyphs in 'solid_numbers_a_10' theme.
68         byobu-ulevel -l -t solid_numbers_a_10
69
70       Display a user-specified rating theme 10 glyphs wide.
71         byobu-ulevel -c 666.321 -m -273.15 -x 1370 -u "· ☢" -w 10
72
73       A multi-element user theme (this prints 'e').
74         byobu-ulevel -c 50 -u "a b c d e f g h i j"
75
76

NOTES

78       Arguments of type "<int>" denote an integer value, whereas arguments of
79       type "<num>" denotes either an integer or a floating-point number.
80
81       The  final  '_<number>' in a theme name denotes the number of glyphs in
82       it.
83
84       "Rating themes" are those with only 2 values.
85
86       The <chars> argument to '-u' must contain space-delimited characters.
87
88

AUTHOR

97       This utility was written by James Hunt <james.hunt@canonical.com>,  and
98       this  manpage  was  written by Dustin Kirkland <kirkland@byobu.org> for
99       Ubuntu systems (but may be used by others).  Permission is  granted  to
100       copy,  distribute and/or modify this document and the utility under the
101       terms of the GNU General Public License, Version  3  published  by  the
102       Free Software Foundation.
103
104       The  complete  text  of  the GNU General Public License can be found in
105       /usr/share/common-licenses/GPL  on   Debian/Ubuntu   systems,   or   in
106       /usr/share/doc/fedora-release-*/GPL on Fedora systems, or on the web at
107       http://www.gnu.org/licenses/gpl.txt.
108
109
110
111byobu                             16 Dec 2013                  byobu-ulevel(1)