setwallpaper(1) User Commands setwallpaper(1)

setwallpaper - set the desktop wallpaper

setwallpaper [options] [path or URL to JPEG or PNG image]

setwallpaper sets the desktop wallpaper to the specified image file. It supports both local file paths and URLs to remote images. The tool automatically detects the current desktop environment or window manager and uses the appropriate method to set the wallpaper.

Enable verbose output showing detailed information about the operation.
Set wallpaper mode: stretch, center, tile, scale, plus modes specific to the currently running desktop environment or window manager. Default is "stretch".
Specify download directory for images fetched from URLs. If not specified, the system's default download directory is used.
Show the current version.

5.14.2

setwallpaper was written by Alexander F. Rødseth <xyproto@archlinux.org>

23 Jul 2025 setwallpaper