.\" Generated by scdoc 1.11.3
.\" 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 "swww" "1" "2024-06-09"
.PP
.SH NAME
swww - A Solution to your Wayland Wallpaper Woes
.PP
.SH SYNOPSIS
\fBswww\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
Fills the specified outputs with the given color
.PP
.RE
\fBimg\fR
.RS 4
Sends an image (or animated gif) for the daemon to display
.PP
.RE
\fBinit\fR
.RS 4
Initializes the daemon
.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
\fBswww\fR is a wallpaper manager that lets you change what your monitors display as
a background by controlling the \fBswww-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 \fBswww init\fR.\& That will set up the \fBswww-daemon\fR.\&
Then, you can send images to be displayed with \fBswww img\fR.\& To kill the daemon,
use \fBswww kill\fR.\&
.PP
\fBNote that swww only works in a compositor that implements the layer-shell
protocol\fR.\& Typically, \fIwlr-roots\fR based compositors.\&
.PP
.SH FILES
\fBswww\fR will create the following files in your system:
.RS 4
.PD 0
.IP \(bu 4
A socket in \fI${XDG_RUNTIME_DIR}/swww-${WAYLAND_DISPLAY}.\&socket\fR,  or
.PD
.RE
\fI/tmp/swww/swww-${WAYLAND_DISPLAY}.\&socket\fR, if $XDG_RUNTIME_DIR is not set.\&
.RS 4
.PD 0
.IP \(bu 4
Cache files in \fI$XDG_CACHE_HOME/swww\fR or \fI$HOME/.\&cache/swww\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
\fBswww-daemon\fR(1) \fBswww-clear\fR(1) \fBswww-img\fR(1) \fBswww-init\fR(1) \fBswww-kill\fR(1)
\fBswww-query\fR(1)