.\" 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-daemon" "1" "2026-03-24"
.PP
.SH NAME
awww-daemon
.PP
.SH SYNOPSIS
awww-daemon [OPTIONS]
.PP
.SH OPTIONS
.PP
\fB-f\fR,\fB--format\fR <argb|abgr|rgb|bgr>
.RS 4
Force the daemon to use a specific wl_shm format.\&
.PP
By default, awww-daemon will use argb, because it is most widely
supported.\& Generally speaking, formats with 3 channels will use 3/4 the
memory of formats with 4 channels.\& Also, bgr formats are more efficient
than rgb formats because we do not need to do an extra swap of the bytes
when decoding the image (though the difference is unnoticiable).\&
.PP
.RE
\fB-l\fR,\fB--layer\fR <background|bottom>
.RS 4
Which layer to display the background in.\& Defaults to \fBbackground\fR.\&
.PP
We do not accept layers \fBtop\fR and \fBoverlay\fR because those would make your
desktoop unusable by simply putting an image on top of everything else.\& If
there is ever a use case for these, we can reconsider it.\&
.PP
.RE
\fB-n\fR,\fB--namespace\fR <namespace>
.RS 4
Which wayland namespace to append to \fBawww-daemon\fR.\&
.PP
The result namespace will the \fBawww-daemon<specified namespace>\fR.\& This also
affects the name of the \fBawww-daemon\fR socket we will use to communicate
with the \fBclient\fR.\& 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--no-cache\fR
.RS 4
Don'\&t search the cache for the last wallpaper for each output.\&
Useful if you always want to select which image '\&awww'\& loads manually using
\&'\&awww img'\&
.PP
.RE
\fB-q\fR,\fB--quiet\fR
.RS 4
Makes the daemon only log errors.\&
.PP
.RE
\fB-h\fR, \fB--help\fR
.RS 4
Print help (see a summary with '\&-h'\&)
.PP
.RE
\fB-V\fR, \fB--version\fR
.RS 4
Print version
.PP
.RE
.SH DESCRIPTION
.PP
The \fBawww-daemon\fR will run continuously, waiting for commands in
\fI${XDG_RUNTIME_DIR}/awww-${WAYLAND_DISPLAY}.\&socket\fR (or
\fI/tmp/awww/awww-${WAYLAND_DISPLAY}.\&socket\fR, if $XDG_RUNTIME_DIR is not set).\& The
daemon will take care of both creating and deleting that file when it is
initialized or killed.\&
.PP
.SH SEE ALSO
\fBawww\fR(1)