1yambar-modules-dwl(5)         File Formats Manual        yambar-modules-dwl(5)
2
3
4

NAME

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

DESCRIPTION

9       This module provides a map of each tags present in dwl.
10
11       Each tags has its id, its name, its status (selected, empty, urgent)
12       and the global data like title, appid, fullscreen, floating, selmon,
13       and layout). The tags start a 1. For needs where you only want informa‐
14       tion about the global data and not the tags, there is a tag with the id
15       0 that contains only the global data.
16
17       This module will track only the monitor where yambar was launched on.
18       If you have a multi monitor setup, please launch yambar on each of your
19       monitors.
20
21       Please, be aware that only one instance of this module is supported.
22       Running multiple instances at the same time may result in undefined be‐
23       havior.
24

TAGS

26       ┌───────────┬────────┬─────────────────────────────────────────────────┐
27Name       Type   Description                                     
28       ├───────────┼────────┼─────────────────────────────────────────────────┤
29       │id         │ int    │ Dwl tag id.                                     │
30       ├───────────┼────────┼─────────────────────────────────────────────────┤
31       │name       │ string │ The name of the tag (defaults to id if not      │
32       │           │        │ set).                                           │
33       ├───────────┼────────┼─────────────────────────────────────────────────┤
34       │selected   │ bool   │ True if the tag is currently selected.          │
35       ├───────────┼────────┼─────────────────────────────────────────────────┤
36       │empty      │ bool   │ True if there are no windows in the tag.        │
37       ├───────────┼────────┼─────────────────────────────────────────────────┤
38       │urgent     │ bool   │ True if the tag has the urgent flag set.        │
39       ├───────────┼────────┼─────────────────────────────────────────────────┤
40       │title      │ string │ The currently focused window's title.           │
41       ├───────────┼────────┼─────────────────────────────────────────────────┤
42       │appid      │ string │ The currently focused window's application id.  │
43       ├───────────┼────────┼─────────────────────────────────────────────────┤
44       │fullscreen │ bool   │ True if there is a fullscreen window in the     │
45       │           │        │ current tag.                                    │
46       ├───────────┼────────┼─────────────────────────────────────────────────┤
47       │floating   │ bool   │ True if there is a floating window in the cur‐  │
48       │           │        │ rent tag.                                       │
49       ├───────────┼────────┼─────────────────────────────────────────────────┤
50       │selmon     │ bool   │ True if the monitor is actually focused.        │
51       ├───────────┼────────┼─────────────────────────────────────────────────┤
52       │layout     │ string │ The actual layout name of the tag.              │
53       └───────────┴────────┴─────────────────────────────────────────────────┘
54

CONFIGURATION

56       ┌───────────────┬────────┬───────┬─────────────────────────────────────┐
57Name           Type   Req   Description                         
58       ├───────────────┼────────┼───────┼─────────────────────────────────────┤
59       │number-of-tags │ int    │ yes   │ The number of defined tags in the   │
60       │               │        │       │ dwl `config.def.h`.                 │
61       ├───────────────┼────────┼───────┼─────────────────────────────────────┤
62       │name-of-tags   │ list   │ false │ The name of the tags (must have the │
63       │               │        │       │ same length that number-of-tags).   │
64       ├───────────────┼────────┼───────┼─────────────────────────────────────┤
65       │dwl-info-file‐ │ string │ yes   │ The filepath to the log emitted by  │
66       │name           │        │       │ dwl when running.                   │
67       └───────────────┴────────┴───────┴─────────────────────────────────────┘
68

EXAMPLES

70           bar:
71             left:
72               - dwl:
73                   number-of-tags: 9
74                   dwl-info-filename: "/home/ogromny/dwl_info"
75                   name-of-tags: [ , , , , , , , ,  ]
76                   content:
77                     list:
78                       items:
79                         - map:
80                             conditions:
81                               # default tag
82                               id == 0: {string: {text: "{layout} {title}"}}
83
84                               selected: {string: {text: "-> {name}"}}
85                               ~empty: {string: {text: "{name}"}}
86                               urgent: {string: {text: "=> {name} <="}}
87

SEE ALSO

89       yambar-modules(5), yambar-particles(5), yambar-tags(5), yambar-decora‐
90       tions(5)
91
92                                  2023-07-22             yambar-modules-dwl(5)
Impressum