waybar-river-tags(5)

NAME

waybar - river tags module

DESCRIPTION

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.

EXAMPLE

    "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.

SEE ALSO

waybar(5), river(1)