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)