Manpage logo

swww-restore - (unknown subject)

NAME  SYNOPSIS  OPTIONS  DESCRIPTION  SEE ALSO 

NAME

swww-restore

SYNOPSIS

swww restore

OPTIONS

-a,--all

Send this command to all active ‘swww-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: ‘swww restore -n <namespace1> -n <namespace 2>‘.

This affects the name of the ‘swww-daemon‘ socket we will use to communicate with. Specifically, our socket name is ${WAYLAND_DISPLAY}-swww-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 swww 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 ‘swww 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

swww-clear-cache(1)


Updated 2026-06-01 - jenkler.se | uex.se