.\" Generated by scdoc 1.11.4
.\" 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 "awww-query" "1" "2026-03-24"
.PP
.SH NAME
awww-query
.PP
.SH SYNOPSIS
\fBawww query\fR
.PP
.SH OPTIONS
.PP
\fB-a\fR,\fB--all\fR
.RS 4
Send this command to all active \fBawww-daemon\fR namespaces.\&
.PP
.RE
\fB-j\fR,\fB--j\fR
.RS 4
Print the information in \fBjson\fR format.\&
.PP
.RE
\fB-n\fR,\fB--namespace\fR <namespace>
.RS 4
Which wayland namespace to send this command to.\&
.PP
You can specify this option multiple times to send commands to multiple
namespaces at once: \fBawww query -n <namespace1> -n <namespace 2>\fR.\&
.PP
This affects the name of the \fBawww-daemon\fR socket we will use to
communicate with.\& Specifically, our socket name is
\fI${WAYLAND_DISPLAY}-awww-daemon.\&<specified namespace>.\&socket\fR.\&
.PP
Some compositors can have several different wallpapers per output.\& This
allows you to differentiate between them.\& Most users will probably not have
to set anything in this option.\&
.PP
.RE
\fB-h\fR, \fB--help\fR
.RS 4
Print help (see a summary with '\&-h'\&)
.PP
.RE
.SH DESCRIPTION
.PP
Asks the daemon to print output information (names and dimensions).\&
.PP
You may use this to find out valid values for the <awww-img --outputs> option.\& If
you want more detailed information about your outputs, I would recommend trying
something like \fBwlr-randr\fR.\&
.PP
.SH OUTPUT FORMAT
.PP
Currently, \fBawww query\fR prints information in the following format:
.PP
.nf
.RS 4
NAMESPACE: OUTPUT: SIZE, scale: SCALE, currently displaying: IMAGE_OR_COLOR
.fi
.RE
.PP
where \fBSIZE\fR is in the format \fBWxH\fR (eg.\&: \fB1920x1080\fR), \fBSCALE\fR in "scale:
NUMBER", and \fBIMAGE_OR_COLOR\fR in
.RS 4
.PD 0
.IP \(bu 4
"image: IMAGENAME", if it'\&s an image; or
.IP \(bu 4
"color: RGB", if it'\&s a color
.PD
.PP
.RE
.SH JSON FORMAT
.PP
The \fBjson\fR format will print information like so:
.PP
.nf
.RS 4
{
"NAMESPACE": [<LIST OF OUTPUTS>]
}
.fi
.RE
.PP
Where each output in the list is in format:
.PP
.nf
.RS 4
{
	"name": <NAME>,
	"width": <WIDTH>,
	"height": <HEIGHT>,
	"scale": <SCALE>,
	"displaying": {
		"image" OR "color": <PATH/TO/IMAGE> OR <COLOR IN HEXA>
	},
}
.fi
.RE