.\" 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" "1" "2026-03-24"
.PP
.SH NAME
awww - An Answer to your Wayland Wallpaper Woes
.PP
.SH SYNOPSIS
\fBawww\fR <COMMAND>
.PP
.SH COMMANDS
.PP
\fBclear\fR
.RS 4
Fills the specified outputs with the given color
.PP
.RE
\fBrestore\fR
.RS 4
Restores the last displayed image on the specified outputs
.PP
.RE
\fBclear-cache\fR
.RS 4
Deletes the \fBawww\fR cache directory
.PP
.RE
\fBimg\fR
.RS 4
Sends an image (or animated gif) for the daemon to display
.PP
.RE
\fBkill\fR
.RS 4
Kills the daemon
.PP
.RE
\fBquery\fR
.RS 4
Asks the daemon to print output information (names and dimensions)
.PP
.RE
\fBhelp [COMMAND]\fR
.RS 4
Print help or the help of the given command
.PP
.RE
.SH OPTIONS
.PP
\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
\fBawww\fR is a wallpaper manager that lets you change what your monitors display as
a background by controlling the \fBawww-daemon\fR at runtime.\&
.PP
It supports animated gifs and putting different stuff in different monitors.\& I
also did my best to make it as resource efficient as possible.\&
.PP
To start, begin by running \fBawww-daemon\fR.\& That will set up the \fBawww-daemon\fR.\&
Then, you can send images to be displayed with \fBawww img\fR.\& To kill the daemon,
use \fBawww kill\fR.\&
.PP
\fBNote that awww only works in a compositor that implements the layer-shell
protocol\fR.\& Typically, \fIwlr-roots\fR based compositors.\&
.PP
.SH FILES
\fBawww\fR will create the following files in your system:
.RS 4
.PD 0
.IP \(bu 4
A socket in \fI${XDG_RUNTIME_DIR}/${WAYLAND_DISPLAY}-awww-daemon.\&<specified
.PD
.RE
namespace>.\&socket\fR,  or
.RS 4
\fI/tmp/awww/${WAYLAND_DISPLAY}-awww-daemon.\&<specified namespace>.\&socket\fR, if
$XDG_RUNTIME_DIR is not set.\&
.PD 0
.IP \(bu 4
Cache files in \fI$XDG_CACHE_HOME/awww\fR or \fI$HOME/.\&cache/awww\fR if
$XDG_CACHE_HOME does not exist.\& These are used to set the wallpaper to the
previous image when a monitor is (re)connected or turned on.\&
.PD
.PP
.RE
.SH SEE ALSO
\fBawww-daemon\fR(1) \fBawww-clear\fR(1) \fBawww-img\fR(1) \fBawww-kill\fR(1) \fBawww-query\fR(1)