---
name: "yambar"
section: "1"
platform: "linux"
package: "yambar"
version: "1.11.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/yambar"
---

# yambar(1)

modular status panel for X11 and Wayland

## 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)](/yambar/5.md)