.\" 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-clear" "1" "2026-03-24"
.PP
.SH NAME
awww-clear
.PP
.SH SYNOPSIS
\fBawww clear\fR [OPTIONS] <COLOR>
.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-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 clear -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-o\fR, \fB--outputs\fR
.RS 4
Comma separated list of outputs to display the image at.\& Use \fBawww query\fR to
know which outputs are currently being used.\&
.PP
If it isn'\&t set, the image is displayed on all outputs.\&
.PP
.RE
\fB-h\fR, \fB--help\fR
.RS 4
Print help (see a summary with '\&-h'\&)
.PP
.RE
.SH COLOR
.PP
The color to fill the screen with.\& It must be given in \fBRRGGBB\fR, hex format.\& Note
there is no prepended '\&#'\&.\& Defaults to \fB000000\fR.\&
.PP
.SH DESCRIPTION
Fills the specified outputs with the given color.\&
.PP
Currently, we \fBdo not\fR cache this, so if you want a color to be set at
initialization, you must set it every time:
.PP
.nf
.RS 4
awww-daemon && awww clear 1a804a
.fi
.RE
.PP
.SH SEE ALSO
\fBawww-query\fR(1)