Manpage logo

yambar - configuration file

NAME  DESCRIPTION  FORMAT  EXAMPLES  FILES  SEE ALSO 

NAME

yambar - configuration file

DESCRIPTION

A yambar configuration file is a yaml formatted document containing an associative array named bar. You may define other top-level entities and reference them using anchors.

Besides the normal yaml types, there are a couple of yambar specific types that are frequently used:

font: this is a comma separated list of fonts in fontconfig format. Example of valid values:

Font Awesome 6 Brands

Font Awesome 6 Free:style=solid

Dina:pixelsize=10:slant=italic

Dina:pixelsize=10:weight=bold

color: an rgba hexstring; RRGGBBAA. Examples:

ffffffff: white, no transparency

000000ff: black, no transparency

00ff00ff: green, no transparency

ff000099: red, semi-transparent

FORMAT

EXAMPLES

Top-oriented bar with a single, right-aligned, module: the clock, rendered as a simple string displaying only the time (not date).

bar:
location: top
height: 26
background: 00000066

right:
- clock:
content:
- string: {text: "{time}"}

FILES

The configuration file is searched for (in this order):

$XDG_CONFIG_HOME/yambar/config.yml

$HOME/.config/yambar/config.yml

SEE ALSO

yambar-modules(5), yambar-particles(5), yambar-tags(5), yambar-decorations(5)


Updated 2026-06-01 - jenkler.se | uex.se