.\" 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-restore" "1" "2026-05-23"
.PP
.SH NAME
awww-restore
.PP
.SH SYNOPSIS
\fBawww restore\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-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 restore -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
.PP
.RE
\fB-o\fR, \fB--outputs\fR
.RS 4
Comma separated list of outputs to restore.\& Use \fBawww query\fR to know which
outputs are currently being used.\&
.PP
If it isn'\&t set, all outputs will be restored.\&
.PP
.RE
\fB-h\fR, \fB--help\fR
.RS 4
Print help (see a summary with '\&-h'\&)
.PP
.RE
.SH DESCRIPTION
.PP
Restores the last displayed image on the specified outputs.\&
.PP
This can be used to split initialization (with \fBawww init --no-daemon\fR) and
cache loading into different steps, in order to avoid race condition traps.\&
.PP
You can also use this command to restore the last displayed image when
reconnecting a monitor.\&
.PP
.SH SEE ALSO
\fBawww-clear-cache\fR(1)