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)

                                                   2025-02-21                               waybar-river-tags(5)