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

# yambar(5)

configuration file

## 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

| | | | |
| --- | --- | --- | --- |
| **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)](/yambar-modules/5.md)) |
| center | list | no | Center-aligned modules (see [**yambar-modules**(5)](/yambar-modules/5.md)) |
| right | list | no | Right-aligned modules (see [**yambar-modules**(5)](/yambar-modules/5.md)) |

## 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-modules/5.md), [**yambar-particles**(5)](/yambar-particles/5.md), [**yambar-tags**(5)](/yambar-tags/5.md), [**yambar-decorations**(5)](/yambar-decorations/5.md)