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 Fills the specified outputs with the given color img Sends an image (or animated gif) for the daemon to display init Initializes the daemon 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 init. That will set up the swww-daemon. 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}/swww-${WAYLAND_DISPLAY}.socket, or /tmp/swww/swww-${WAYLAND_DISPLAY}.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-init(1) swww-kill(1) swww-query(1) 2025-04-13 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+14.3.quarterly>