NAME

       yambar - modular status panel for X11 and Wayland

SYNOPSIS

       yambar [OPTIONS]...

OPTIONS

       -b,--backend={xcb,wayland,auto}
           Backend  to  use.  The  default  is auto. In this mode, yambar will look for the environment variable
           WAYLAND_DISPLAY, and if available, use the Wayland backend. If not, the XCB backend is used.

       -c,--config=FILE
           Use an alternative configuration file instead of the default one.

       -C,--validate
           Verify the configuration and then quit. If no errors are detected, nothing is printed  and  the  exit
           code is 0. If there are errors, these are printed on stdout and the exit code is non-zero.

       -p,--print-pid=FILE|FD
           Print  PID  to  this  file,  or FD, when successfully started. The file (or FD) is closed immediately
           after writing the PID. When a FILE as been specified, the file is unlinked exit.

       -d,--log-level={info,warning,error,none}
           Log level, used both for log output on stderr as well as syslog. Default: warning.

       -l,--log-colorize=[{never,always,auto}]
           Enables or disables colorization of log output on stderr.

       -s,--log-no-syslog
           Disables syslog logging. Logging is only done on stderr.

       -v,--version
           Show the version number and quit

DESCRIPTION

       yambar is a lightweight and configurable status panel (bar, for short) for X11 and Wayland.

       It has a number of modules that provide information in the form of tags. For example,  the  clock  module
       has a date tag that contains the current date.

       The modules do not know how to present the information though. This is instead done by particles. And the
       user, you, decides which particles (and thus how to present the data) to use.

       Furthermore,  each  particle  can  have a decoration. These are things like a different background, or an
       graphical underline.

       There is no support for images or icons. use an icon font (e.g. Font Awesome, or Material Icons)  if  you
       want a graphical representation.

       There  are  a  number  of modules and particles builtin. More can be added as plugins. You can even write
       your own!

CONFIGURATION

       See yambar(5)

                                                   2024-04-20                                          yambar(1)