---
name: "yambar-modules-dwl"
section: "5"
platform: "linux"
package: "yambar"
version: "1.11.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/yambar-modules-dwl"
---

# yambar-modules-dwl(5)

This module provides information about dwl tags, and information.

## 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 *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

| | | |
| --- | --- | --- |
| **Name** | **Type** | **Description** |
| id | int | dwl tag id. |
| name | string | The name of the tag (defaults to *id* if not set). |
| 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. |
| appid | string | The currently focused window's application id. |
| 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

| | | | |
| --- | --- | --- | --- |
| **Name** | **Type** | **Req** | **Description** |
| number-of-tags | int | yes | The number of defined tags in the dwl \`config.def.h\`. |
| name-of-tags | list | false | The name of the tags (must have the same length that *number-of-tags*). |
| 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"
        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-modules/5.md), [**yambar-particles**(5)](/yambar-particles/5.md), [**yambar-tags**(5)](/yambar-tags/5.md), [**yambar-decorations**(5)](/yambar-decorations/5.md)