setwallpaper(1)

📦 version 5.14.4, in arch rolling

💖 setwallpaper(1) 💖

Hii bestie!! 💅 Welcome to the User Commands manual page for setwallpaper(1) — the program literally called setwallpaper. It's giving “I set your desktop wallpaper and I know exactly how your desktop environment / window manager likes it.” Periodt. 🦋

✨ NAME ✨

setwallpaper — set the desktop wallpaper. No cap, that's the whole job. 🎀

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

Okay so 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. Literally main character energy: it adapts, it slays, it handles the vibes. ✨

💜 OPTIONS 💜

  • -v, --verbose — turns on verbose output, aka it shows detailed information about the operation. If you're a “tell me everything” bestie, this is your moment. 👀
  • -m, --mode — sets the wallpaper mode: stretch, center, tile, scale, plus modes specific to the currently running desktop environment or window manager. Default is "stretch". Choose your fighter 💅
  • -d, --download — specifies the download directory for images fetched from URLs. If you don't specify it, the system's default download directory is used. Cute and convenient, honestly. 🍓
  • -V, --version — shows the current version. Iconic little “who am I?” flag. 👑

🌈 VERSION 🌈

5.14.3 — that's the version, bestie. 💖

🎀 AUTHOR 🎀

The author line is literally: setwallpaper was written by Alexander F. Rødseth <xyproto@archlinux.org> — give them their flowers, always. 💐

Sign-off cuteness: this page comes from the setwallpaper source/version stamp, dated 04 Jun 2026, and the manual name is setwallpaper(1) — mwah 💋✨

📦 where this page comes from