yambar-modules-dwl - Man Page

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 name, its status (selected, empty, urgent) and the global data like title, appid, 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
idintdwl tag id.
namestringThe name of the tag (defaults to id if not set).
selectedboolTrue if the tag is currently selected.
emptyboolTrue if there are no windows in the tag.
urgentboolTrue if the tag has the urgent flag set.
titlestringThe currently focused window's title.
appidstringThe currently focused window's application id.
fullscreenboolTrue if there is a fullscreen window in the current tag.
floatingboolTrue if there is a floating window in the current tag.
selmonboolTrue if the monitor is actually focused.
layoutstringThe actual layout name of the tag.

Configuration

NameTypeReqDescription
number-of-tagsintyesThe number of defined tags in the dwl `config.def.h`.
name-of-tagslistfalseThe name of the tags (must have the same length that number-of-tags).
dwl-info-filenamestringyesThe filepath to the log emitted by dwl when running.

Examples

  bar:
    left:
      - dwl:
          number-of-tags: 9
          dwl-info-filename: "/home/ogromny/dwl_info"
          name-of-tags: [ , , , , , , , ,  ]
          content:
            list:
              items:
                - map:
                    conditions:
                      # default tag
                      id == 0: {string: {text: "{layout} {title}"}}

                    selected: {string: {text: "-> {name}"}}
                    ~empty: {string: {text: "{name}"}}
                    urgent: {string: {text: "=> {name} <="}}

See Also

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

Referenced By

yambar-modules(5).

2024-07-20