awww-restore(1) General Commands Manual awww-restore(1)

awww-restore

awww restore

-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')

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.

awww-clear-cache(1)

2026-05-23