yambar-modules-river - Man Page

This module provides information about the river tags

Description

This module uses river's (https://github.com/ifreund/river, a dynamic tiling Wayland compositor) status protocol to provide information about the river tags.

It has an interface similar to the i3/sway module.

The configuration for the river module specifies one title particle, which will be instantiated once for each seat, with tags representing the seats' name and the title of the seats' currently focused view.

It also specifies a content template particle, which is instantiated once for all 32 river tags. This means you probably want to use a map particle to hide unused river tags.

Tags

NameTypeDescription
idintRiver tag number
urgentboolTrue if the river tag has at least one urgent view.
visibleboolTrue if the river tag is focused by at least one output (i.e. visible on at least one monitor).
focusedboolTrue if the river tag is visible and has keyboard focus.
occupiedboolTrue if the river tag has views (i.e. windows).
statestringSet to urgent if urgent is true, focused if focused is true, unfocused if visible is true, but focused is false, or invisible if the river tag is not visible on any monitors.
seatstringThe name of the seat (title particle only, see Configuration)
titlestringThe seat's focused view's title (title particle only, see Configuration)

Configuration

NameTypeReqDescription
titleparticlenoParticle that will be instantiated with the seat and title tags.
contentparticleyesTemplate particle that will be instantiated once for all of the 32 river tags.
all-monitorsboolnoWhen set to false (the default), tags reflect river tags and seats for the monitor yambar is on only. When set to true, tags reflect the union of all monitors.

Examples

  bar:
    left:
      - river:
          title: {string: { text: "{seat} - {title}" }}
          content:
            map:
              tag: occupied
              values:
                false: {empty: {}}
                true:
                  string:
                    margin: 5
                    text: "{id}: {state}"

See Also

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

Referenced By

yambar-modules(5).

2022-08-26