waybar-river-tags(5)

waybar-river-tags5

River tags module

Overview

The tags module displays the current state of tags in river.

Configuration

Addressed by river/tags

num-tags:
typeof: uint
default: 9
The number of tags that should be displayed. Max 32.

tag-labels:
typeof: array
The label to display for each tag.

disable-click:
typeof: bool
default: false
If set to false, you can left-click to set focused tag. Right-click to toggle tag focus. If set to true this behaviour is disabled.

expand:
typeof: bool
default: false
Enables this module to consume all left over space dynamically.

hide-vacant:
typeof: bool
default: false
Only show relevant tags: tags that are either focused or have a window on them.

Examples

"river/tags": {
	"num-tags": 5
}

Style

•

#tags button

•

#tags button.occupied

•

#tags button.focused

•

#tags button.urgent

Note that occupied/focused/urgent status may overlap. That is, a tag may be both occupied and focused at the same time.

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

From waybar 0.15.0-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.