---
name: "awww-restore"
section: "1"
platform: "linux"
package: "awww"
version: "0.12.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/awww-restore"
---

# awww-restore(1)

## NAME

awww-restore

## SYNOPSIS

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

## DESCRIPTION

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.

## SEE ALSO

[**awww-clear-cache**(1)](/awww-clear-cache/1.md)