.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "yambar\-modules\-dwl" "5" "2026\-09\-18"
.PP
.SH NAME
dwl \- This module provides information about dwl tags, and information.\&
.PP
.SH DESCRIPTION
.PP
This module provides a map of each tags present in dwl.\&
.PP
Each tags has its \fIid\fR, its \fIname\fR, its status (\fIselected\fR, \fIempty\fR, \fIurgent\fR)
and the global data like \fItitle\fR, \fIappid\fR, \fIfullscreen\fR, \fIfloating\fR,
\fIselmon\fR, and \fIlayout\fR).\& The tags start a 1.\& For needs where
you only want information about the global data and not the \fItags\fR,
there is a tag with the id \fI0\fR that contains only the global data.\&
.PP
This module will track \fBonly\fR the monitor where yambar was launched on.\&
If you have a multi monitor setup, please launch yambar on each of your
monitors.\&
.PP
Please, be aware that only \fBone instance\fR of this module is supported.\&
Running multiple instances at the same time may result in 
\fBundefined behavior\fR.\&
.PP
.SH TAGS
.PP
.TS
allbox;l l lx
l l lx
l l lx
l l lx
l l lx
l l lx
l l lx
l l lx
l l lx
l l lx
l l lx
l l lx.
T{
\fBName\fR
T}	T{
\fBType\fR
T}	T{
\fBDescription\fR
T}
T{
id
T}	T{
int
T}	T{
dwl tag id.\&
T}
T{
name
T}	T{
string
T}	T{
The name of the tag (defaults to \fIid\fR if not set).\&
T}
T{
selected
T}	T{
bool
T}	T{
True if the tag is currently selected.\&
T}
T{
empty
T}	T{
bool
T}	T{
True if there are no windows in the tag.\&
T}
T{
urgent
T}	T{
bool
T}	T{
True if the tag has the urgent flag set.\&
T}
T{
title
T}	T{
string
T}	T{
The currently focused window'\&s title.\&
T}
T{
appid
T}	T{
string
T}	T{
The currently focused window'\&s application id.\&
T}
T{
fullscreen
T}	T{
bool
T}	T{
True if there is a fullscreen window in the current tag.\&
T}
T{
floating
T}	T{
bool
T}	T{
True if there is a floating window in the current tag.\&
T}
T{
selmon
T}	T{
bool
T}	T{
True if the monitor is actually focused.\&
T}
T{
layout
T}	T{
string
T}	T{
The actual layout name of the tag.\&
T}
.TE
.sp 1
.SH CONFIGURATION
.PP
.TS
allbox;l l l lx
l l l lx
l l l lx
l l l lx.
T{
\fBName\fR
T}	T{
\fBType\fR
T}	T{
\fBReq\fR
T}	T{
\fBDescription\fR
T}
T{
number\-of\-tags
T}	T{
int
T}	T{
yes
T}	T{
The number of defined tags in the dwl `config.\&def.\&h`.\&
T}
T{
name\-of\-tags
T}	T{
list
T}	T{
false
T}	T{
The name of the tags (must have the same length that \fInumber\-of\-tags\fR).\&
T}
T{
dwl\-info\-filename
T}	T{
string
T}	T{
yes
T}	T{
The filepath to the log emitted by dwl when running.\&
T}
.TE
.sp 1
.SH EXAMPLES
.PP
.nf
.RS 4
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} <="}}
.fi
.RE
.PP
.SH SEE ALSO
.PP
\fByambar\-modules\fR(5), \fByambar\-particles\fR(5), \fByambar\-tags\fR(5), \fByambar\-decorations\fR(5)
.PP