yambar-decorations - Man Page

configuration file

Description

Decorations are optional additions to particles, enabling you to e.g. change the background color of the entire particle, draw an underline and so on.

Decorations are applied to the particle's margins as well.

All decorations define their own configuration attributes, and there are no common attributes.

Background

This decoration sets the particles background color.

Configuration

NameTypeReqDescription
colorcoloryesThe background color. See yambar(5) for format.

Examples

  content:
    string:
      deco:
        background:
          color: 00ff00ff

Underline

This decoration renders a line of configurable size and color at the bottom of the particle.

Configuration

NameTypeReqDescription
sizeintyesThe size (height/thickness) of the line, in pixels
colorcoloryesThe color of the line. See yambar(5) for format.

Examples

  content:
    string:
      deco:
        underline:
          size: 2
          color: ff0000ff

Overline

Similar to underline, this decoration renders a line of configurable size and color at the top of the particle.

Configuration

NameTypeReqDescription
sizeintyesThe size (height/thickness) of the line, in pixels
colorcoloryesThe color of the line. See yambar(5) for format.

Examples

  content:
    string:
      deco:
        overline:
          size: 2
          color: ff0000ff

Border

This decoration renders a border of configurable size (i.e border width) around the particle.

Configuration

NameTypeReqDescription
colorcoloryesThe color of the line. See yambar(5) for format.
sizeintnoBorder width, in pixels. Defaults to 1px.

Examples

  content:
    string:
      deco:
        border:
          size: 2
          color: ff0000ff

Stack

This particles combines multiple decorations.

Configuration

No configuration attributes available. The stack is just a list of the decorations that should be combined.

Examples

  content:
    string:
      deco:
        stack:
          - background: ...
          - underline: ...

See Also

yambar-particles(5)

Referenced By

yambar(5), yambar-modules(5), yambar-modules-alsa(5), yambar-modules-backlight(5), yambar-modules-battery(5), yambar-modules-clock(5), yambar-modules-cpu(5), yambar-modules-disk-io(5), yambar-modules-dwl(5), yambar-modules-foreign-toplevel(5), yambar-modules-i3(5), yambar-modules-label(5), yambar-modules-mem(5), yambar-modules-mpd(5), yambar-modules-network(5), yambar-modules-pipewire(5), yambar-modules-pulse(5), yambar-modules-removables(5), yambar-modules-river(5), yambar-modules-script(5), yambar-modules-sway-xkb(5), yambar-modules-xkb(5), yambar-particles(5).

2024-07-20