NAME

       xmobar - A configurable and extensible status bar for X11 desktops

SYNOPSIS

       xmobar [OPTIONS] [CONFIG_FILE]

DESCRIPTION

       xmobar  is  a  minimalistic,  text  based,  status  bar.   It  was originally designed and
       implemented by Andrea Rossato to work with xmonad,  but  it's  actually  usable  with  any
       window-manager.

       xmobar  was inspired by the Ion3 (http://tuomov.iki.fi/software/) status bar, and supports
       similar features, like dynamic  color  management,  output  templates,  and  extensibility
       through plugins.

       This page documents xmobar 0.16.

COMMAND LINE OPTIONS

       xmobar can be either configured with a configuration file or with command line options. In
       the second case, the command line options will overwrite the corresponding options set  in
       the configuration file.

       The configuration file is searched for in the following locations, in order:

              $XDG_CONFIG_HOME/xmobar/xmobarrc (default: ~/.config/xmobar/xmobarrc)
              ~/.xmobarrc

       The  first  configuration  file found will be used. See /usr/share/doc/xmobar/examples for
       sample configuration files.

       Usage:

             xmobar -B white -a right -F blue -t '%LIPB%' -c '[Run Weather "LIPB" [] 36000]'

       This is the list of command line options (the output of xmobar —help):

             Usage: xmobar [OPTION...] [FILE]
             Options:
               -h, -?        --help                 This help
               -V            --version               Show version information
               -f font name  --font=font name        The font name
               -B bg color   --bgcolor=bg color      The background color. Default black
               -F fg color   --fgcolor=fg color      The foreground color. Default grey
               -o            --top                   Place xmobar at the top of the screen
               -b            --bottom                Place xmobar at the bottom of the screen
               -a alignsep   --alignsep=alignsep     Separators for left, center and right text
                                                     alignment. Default: '}{'
               -s char       --sepchar=char          The character used to separate commands in
                                                     the output template. Default '%'
               -t template   --template=template     The output template
               -c commands   --commands=commands     The list of commands to be executed
               -C commands   --add-commands=commands Add commands to be executed after those
                                                     of the config file
               -x screen     --screen=screen         On which X screen number to start
             Mail bug reports and suggestions to <xmobar@projects.haskell.org>

CONFIGURATION

       For  full  details   of   the   available   configuration   options,   please   refer   to
       /usr/share/doc/xmobar/readme.md.gz.

AUTHOR

       Andrea  Rossato  originally  designed  and implemented xmobar up to version 0.11.1.  Since
       then, it is maintained by Jose Antonio Ortega Ruiz (http://hacks-galore.org/jao/).

       This manual page was written by Apollon Oikonomopoulos <apoikos@debian.org> for the Debian
       project (but may be used by others).

LICENSE

       This  software is released under a BSD-style license.  See /usr/share/doc/xmobar/copyright
       for more details.

       Copyright © 2007–2010 Andrea Rossato
       Copyright © 2010–2014 Jose Antonio Ortega Ruiz

                                          July  2, 2014                                 xmobar(1)