awww(1)

💅 awww — An Answer to your Wayland Wallpaper Woes

hey bestie, welcome to awww(1) from the General Commands Manual section — yes it's a real one, and yes it's about to be your new obsession 🎀

✨ SYNOPSIS ✨

awww <COMMAND>

like, that's it. you pick a command, she does the thing. iconic behavior honestly 💅

---

🌸 COMMANDS 🌸

• clear — fills the outputs you specified with the color you gave it. blank canvas era ✨
• restore — puts the last displayed image back up on the outputs you specified. the comeback kid 🫶
• clear-cache — yeets the awww cache directory into the void 🗑️
• img — sends an image (or an animated gif, we love a moving picture 😭) off to the daemon to actually display
• kill — kills the daemon. bye bestie 💀
• query — asks the daemon to print out output information, aka names and dimensions 👑
• help [COMMAND] — prints help, or the help of whatever command you hand it 📖

---

⭐ OPTIONS ⭐

• -h, --help — print help (but peek the summary with -h)
• -V, --version — print version

---

🦋 DESCRIPTION 🦋

okay so awww is a wallpaper manager, and what she does is let you change what your monitors display as a background by controlling the awww-daemon at runtime. main character energy, fr fr 🌈

she supports animated gifs and putting different stuff on different monitors — because why would all your screens match, that's giving boring 🎀 and the author also did their best to make it as resource efficient as possible, which, slay.

to start, begin by running awww-daemon. that will set up the awww-daemon. then you can send images to be displayed with awww img. to kill the daemon, use awww kill. the whole little lifecycle, no cap 💖

heads up bestie: awww only works in a compositor that implements the layer-shell protocol. typically, wlr-roots based compositors. if yours doesn't, this is gonna be a whole situation 😭

---

🧚 FILES 🧚

awww will create the following files in your system:

• a socket in ${XDG_RUNTIME_DIR}/${WAYLAND_DISPLAY}-awww-daemon.<specified namespace>.socket, or /tmp/awww/${WAYLAND_DISPLAY}-awww-daemon.<specified namespace>.socket if $XDG_RUNTIME_DIR is not set.
• cache files in $XDG_CACHE_HOME/awww or $HOME/.cache/awww if $XDG_CACHE_HOME does not exist. these are used to set the wallpaper to the previous image when a monitor is (re)connected or turned on 👀

---

💜 SEE ALSO 💜

awww-daemon(1) awww-clear(1) awww-img(1) awww-kill(1) awww-query(1)

---

kisses, this page is sourced from awww(1) (that's the version, bestie) and dated 2026-05-07 — go forth and wallpaper responsibly 💖✨🎀🦋