.\" Generated by scdoc 1.11.2
.\" 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" "2022-12-17"
.P
.SH NAME
dwl - This module provides information about dwl tags, and information.\&
.P
.SH DESCRIPTION
.P
This module provides a map of each tags present in dwl.\&
.P
Each tags has its \fIid\fR, its status (\fIselected\fR, \fIempty\fR, \fIurgent\fR)
and the global data like \fItitle\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.\&
.P
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.\&
.P
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.\&
.P
.SH TAGS
.P
.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.
T{
\fBName\fR
T}	T{
\fBType\fR
T}	T{
\fBDescription\fR
T}
T{
id
T}	T{
int
T}	T{
Dwl tag id.\&
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{
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
.P
.TS
allbox;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{
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
.P
.nf
.RS 4
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}"}}
.fi
.RE
.P
.SH SEE ALSO
.P
\fByambar-modules\fR(5), \fByambar-particles\fR(5), \fByambar-tags\fR(5), \fByambar-decorations\fR(5)
.P