Provided by: yambar_1.9.0-1_amd64 bug

NAME

       dwl - This module provides information about dwl tags, and information.

DESCRIPTION

       This module provides a map of each tags present in dwl.

       Each tags has its id, its status (selected, empty, urgent) and the global data like title,
       fullscreen, floating, selmon, and layout). The tags start a 1. For needs where you only
       want information about the global data and not the tags, there is a tag with the id 0 that
       contains only the global data.

       This module will track only the monitor where yambar was launched on. If you have a multi
       monitor setup, please launch yambar on each of your monitors.

       Please, be aware that only one instance of this module is supported. Running multiple
       instances at the same time may result in undefined behavior.

TAGS

       ┌───────────┬────────┬────────────────────────────────────────────────────────────────────┐
       │NameTypeDescription                                                        │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │id         │ int    │ Dwl tag id.                                                        │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │selected   │ bool   │ True if the tag is currently selected.                             │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │empty      │ bool   │ True if there are no windows in the tag.                           │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │urgent     │ bool   │ True if the tag has the urgent flag set.                           │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │title      │ string │ The currently focused window's title.                              │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │fullscreen │ bool   │ True if there is a fullscreen window in the current tag.           │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │floating   │ bool   │ True if there is a floating window in the current tag.             │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │selmon     │ bool   │ True if the monitor is actually focused.                           │
       ├───────────┼────────┼────────────────────────────────────────────────────────────────────┤
       │layout     │ string │ The actual layout name of the tag.                                 │
       └───────────┴────────┴────────────────────────────────────────────────────────────────────┘

CONFIGURATION

       ┌──────────────────┬────────┬─────┬───────────────────────────────────────────────────────┐
       │NameTypeReqDescription                                           │
       ├──────────────────┼────────┼─────┼───────────────────────────────────────────────────────┤
       │number-of-tags    │ int    │ yes │ The number of defined tags in the dwl `config.def.h`. │
       ├──────────────────┼────────┼─────┼───────────────────────────────────────────────────────┤
       │dwl-info-filename │ string │ yes │ The filepath to the log emitted by dwl when running.  │
       └──────────────────┴────────┴─────┴───────────────────────────────────────────────────────┘

EXAMPLES

           bar:
             left:
               - dwl:
                   number-of-tags: 9
                   dwl-info-filename: "/home/ogromny/dwl_info"
                   content:
                     list:
                       items:
                         - map:
                             conditions:
                               selected: {string: {text: "-> {id}"}}
                               ~empty: {string: {text: "{id}"}}
                               urgent: {string: {text: "=> {id} <="}}
                               # default tag
                               id == 0: {string: {text: "{layout} {title}"}}

SEE ALSO

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

                                            2022-12-17                      yambar-modules-dwl(5)