{
    "mode": "man",
    "parameter": "byobu-ulevel",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/byobu-ulevel/1/json",
    "generated": "2026-06-16T03:29:31Z",
    "sections": {
        "NAME": {
            "content": "byobu-ulevel  - helper script for notification level indicators\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "byobu-ulevel  is  a helper script that can be used to create history graphs with UTF8 charac‐\nters\n\n",
            "subsections": []
        },
        "USAGE": {
            "content": "byobu-ulevel  [options] -c <currentnum>\n\nbyobu-ulevel  [options] <currentnum>\n\nbyobu-ulevel  <currentnum>\n\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "-a          : Accessibility mode: only output ASCII.  (Also enabled if variable '$a11yvari‐\nable' set).\n-b          : Display current value as space if zero, rather than lowest 'value' of theme.\n-c <num>    : Current value of your indicator.\n-d          : Enable debug output.\n-e <int>    : Number of decimal places to use for accessibility mode (default=$defaultdeci‐\nmalplaces).\n-h          : Show this help.\n-i          : Invert colour scheme (rating themes only).\n-l          : List available themes. If '-t' also specified, show all values  for  specified\ntheme.\n-m <num>    : Minimum value (default=$mindefault).\n-n          : Supress output of newline character.\n-p           : Permissive mode - if current value out of bounds, set it to the nearest bound\n(min or max).\n-q          : Suppress messages (requires '-t').\n-r          : Reverse 'direction' of display (rating theme only).\n-t <theme>  : Name of theme (default=$themedefault).\n-u <chars>  : Specify a user theme (2 or more values).\n-w <int>    : Width of rating theme (default=$widthdefault).\n-x <num>    : Maximum value (default=$maxdefault).\n\n",
            "subsections": []
        },
        "EXAMPLES": {
            "content": "Display character representing 27% using default theme.\nbyobu-ulevel 27\n\nAs above.\nbyobu-ulevel -c 27\n\nExample showing floating-point and negative values.\nbyobu-ulevel -c 1.100001 -m -5.00234 -x 2.71828 -t dice6\n\nUse accessibility mode to display a percentage value (rounded to nearest percentage)\nbyobu-ulevel -m -22.613 -x 5.00212 -c 0.10203 -a -e 0\n\nDisplay value using a \"rating theme\" (displayed left-to-right).\nbyobu-ulevel -c 83 -t stars2\n\nDisplay right-to-left inverted \"rating theme\".\nbyobu-ulevel -c 60 -t diamonds2 -ri\n\nDisplay all glyphs in 'solidnumbersa10' theme.\nbyobu-ulevel -l -t solidnumbersa10\n\nDisplay a user-specified rating theme 10 glyphs wide.\nbyobu-ulevel -c 666.321 -m -273.15 -x 1370 -u \"· ☢\" -w 10\n\nA multi-element user theme (this prints 'e').\nbyobu-ulevel -c 50 -u \"a b c d e f g h i j\"\n\n",
            "subsections": []
        },
        "NOTES": {
            "content": "Arguments of type \"<int>\" denote an integer value, whereas arguments of type \"<num>\"  denotes\neither an integer or a floating-point number.\n\nThe final '<number>' in a theme name denotes the number of glyphs in it.\n\n\"Rating themes\" are those with only 2 values.\n\nThe <chars> argument to '-u' must contain space-delimited characters.\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "byobu(1)\n\n\nhttp://byobu.org\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "This utility was written by James Hunt <james.hunt@canonical.com>, and this manpage was writ‐\nten by Dustin Kirkland <kirkland@byobu.org> for Ubuntu systems (but may be used  by  others).\nPermission  is  granted to copy, distribute and/or modify this document and the utility under\nthe terms of the GNU General Public License, Version 3 published by the Free Software Founda‐\ntion.\n\nThe  complete  text  of  the GNU General Public License can be found in /usr/share/common-li‐\ncenses/GPL on Debian/Ubuntu systems, or in /usr/share/doc/fedora-release-*/GPL on Fedora sys‐\ntems, or on the web at http://www.gnu.org/licenses/gpl.txt.\n\n\n\nbyobu                                        16 Dec 2013                             byobu-ulevel(1)",
            "subsections": []
        }
    },
    "summary": "byobu-ulevel  - helper script for notification level indicators",
    "flags": [],
    "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 dice6",
        "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 stars2",
        "Display right-to-left inverted \"rating theme\".",
        "byobu-ulevel -c 60 -t diamonds2 -ri",
        "Display all glyphs in 'solidnumbersa10' theme.",
        "byobu-ulevel -l -t solidnumbersa10",
        "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\""
    ],
    "see_also": [
        {
            "name": "byobu",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/byobu/1/json"
        }
    ]
}