yambar(5) File Formats Manual yambar(5)

# [NAME](#NAME)

yambar - configuration file

# [DESCRIPTION](#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](#FORMAT)

**Name** **Type** **Req** **Description** height int yes The height of the bar, in pixels (**not** including border) location enum yes one of *top* or *bottom* background color yes Background color monitor string no Monitor to place the bar on. If not specified, the primary monitor will be used layer string no Layer to put bar on. One of *overlay*, *top*, *bottom* or *background*. Wayland only. Default: *bottom*. left-spacing int no Space, in pixels, added **before** each module right-spacing int no Space, in pixels, added **after** each module spacing int no Short-hand for setting both *left-spacing* and *right-spacing* left-margin int no Left-side margin, in pixels right-margin int no Right-side margin, in pixels margin int no Short-hand for setting both *left-margin* and *right-margin* border associative array no Configures the border around the status bar border.left-width int no Width of the border on the left side, in pixels border.right-width int no Width of the border on the right side, in pixels border.top-width int no Width of the border on the top side, in pixels border.bottom-width int no Width of the border on the bottom side, in pixels border.width int no Short-hand for setting *border.left/right/top/bottom-width* border.color color no The color of the border border.left-margin int no Left-side margin, in pixels, from screen edge to bar border.right-margin int no Right-side margin, in pixels, from screen edge to bar border.top-margin int no Top margin, in pixels, from screen edge to bar border.bottom-margin int no Bottom margin, in pixels, from screen edge to bar border.margin int no Short-hand for setting *border.left/right/top/bottom-margin* font font no Default font to use in modules and particles. May also be a comma separated list of several fonts, in which case the first font is the primary font, and the rest fallback fonts. These are yambar custom fallback fonts that will be searched before the fontconfig provided fallback list. font-shaping enum no Default setting for font-shaping, for use in particles. One of *full* or *none*. When set to *full* (the default), strings will be "shaped" using HarfBuzz. Requires support in fcft. foreground color no Default foreground (text) color to use trackpad-sensitivity int no How easy it is to trigger wheel-up and wheel-down on-click handlers. Higher values means you need to drag your finger a longer distance. The default is 30. left list no Left-aligned modules (see [**yambar-modules**(5)](/man/enterprise-packages/yambar/yambar-modules.5)) center list no Center-aligned modules (see [**yambar-modules**(5)](/man/enterprise-packages/yambar/yambar-modules.5)) right list no Right-aligned modules (see [**yambar-modules**(5)](/man/enterprise-packages/yambar/yambar-modules.5))

# [EXAMPLES](#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](#FILES)

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

- *$XDG\_CONFIG\_HOME/yambar/config.yml*
- *$HOME/.config/yambar/config.yml*

# [SEE ALSO](#SEE_ALSO)

[**yambar-modules**(5)](/man/enterprise-packages/yambar/yambar-modules.5), [**yambar-particles**(5)](/man/enterprise-packages/yambar/yambar-particles.5), [**yambar-tags**(5)](/man/enterprise-packages/yambar/yambar-tags.5), [**yambar-decorations**(5)](/man/enterprise-packages/yambar/yambar-decorations.5)

2026-09-18

---

Document: yambar(5) from yambar 1.11.0-r3 (Chainguard OS)
Source: https://codeberg.org/dnkl/yambar