FreeBSD Manual Pages
swww(1) General Commands Manual swww(1) NAME swww - A Solution to your Wayland Wallpaper Woes SYNOPSIS swww <COMMAND> COMMANDS clear Fills the specified outputs with the given color restore Restores the last displayed image on the specified outputs clear-cache Deletes the `swww` cache directory img Sends an image (or animated gif) for the daemon to display kill Kills the daemon query Asks the daemon to print output information (names and dimensions) help [COMMAND] Print help or the help of the given command OPTIONS -h, --help Print help (see a summary with '-h') -V, --version Print version DESCRIPTION swww is a wallpaper manager that lets you change what your monitors display as a background by controlling the swww-daemon at runtime. It supports animated gifs and putting different stuff in different mon- itors. I also did my best to make it as resource efficient as possible. To start, begin by running swww-daemon. That will set up the swww-dae- mon. Then, you can send images to be displayed with swww img. To kill the daemon, use swww kill. Note that swww only works in a compositor that implements the layer- shell protocol. Typically, wlr-roots based compositors. FILES swww will create the following files in your system: • A socket in ${XDG_RUNTIME_DIR}/${WAYLAND_DISPLAY}-swww-dae- mon.<specified namespace>.socket, or /tmp/swww/${WAYLAND_DISPLAY}-swww-daemon.<specificed name- space>.socket, if $XDG_RUNTIME_DIR is not set. • Cache files in $XDG_CACHE_HOME/swww or $HOME/.cache/swww if $XDG_CACHE_HOME does not exist. These are used to set the wall- paper to the previous image when a monitor is (re)connected or turned on. SEE ALSO swww-daemon(1) swww-clear(1) swww-img(1) swww-kill(1) swww-query(1) 2025-11-01 swww(1)
NAME | SYNOPSIS | COMMANDS | OPTIONS | DESCRIPTION | FILES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=swww&sektion=1&manpath=FreeBSD+Ports+15.0>