awww-restore(1)

awww-restore1

Usage

awww restore

Options

-a,--all

Send this command to all active awww-daemon namespaces.

-n,--namespace <namespace>

Which wayland namespace to send this command to.

You can specify this option multiple times to send commands to multiple namespaces at once: awww restore -n <namespace1> -n <namespace 2>.

This affects the name of the awww-daemon socket we will use to communicate with. Specifically, our socket name is ${WAYLAND_DISPLAY}-awww-daemon.<specified namespace>.socket.

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.

-o, --outputs

Comma separated list of outputs to restore. Use awww query to know which outputs are currently being used.

If it isn't set, all outputs will be restored.

-h, --help

Print help (see a summary with '-h')

Overview

Restores the last displayed image on the specified outputs.

This can be used to split initialization (with awww init --no-daemon) and cache loading into different steps, in order to avoid race condition traps.

You can also use this command to restore the last displayed image when reconnecting a monitor.

From awww 0.12.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.