awww-clear(1)

📦
version 0.12.1 · 4 versions
, in alpine 3.24

💅 awww-clear(1) — the group-chat guide

okay so bestie, welcome to awww-clear 💖 this is the part of the awww manual family that's literally just "paint the screen a color, that's it, that's the whole thing." it's giving paint-bucket energy and honestly? iconic.

✨ SYNOPSIS ✨

awww clear [OPTIONS] <COLOR>

that's the whole shape of it. command, some options if you're feeling fancy, and a color. slay 🎀

🌸 OPTIONS 🌸

  • -a, --all — sends this command to all the active awww-daemon namespaces. all of them. like, every single one 🫶
  • -n, --namespace <namespace> — tells it which wayland namespace to send the command to.
    • and yes, you can pass this option multiple times to hit multiple namespaces in one go: awww clear -n <namespace1> -n <namespace 2>. multitasking queen 💅
    • this changes the name of the awww-daemon socket we use to talk to it. specifically, our socket name is ${WAYLAND_DISPLAY}-awww-daemon.<specified namespace>.socket.
    • some compositors can have several different wallpapers per output, and this is how you tell them apart. most users will probably not have to set anything in this option — ngl this one's for the advanced girlies ✨
  • -o, --outputs — a comma separated list of outputs to display the image at. use awww query to know which outputs are currently being used 👀
    • if it isn't set, the image is displayed on all outputs. defaults nation, we love to see it 🌈
  • -h, --help — print help (see a summary with -h). the classic. the goat. blue-check energy 👑

🎨 COLOR 🎨

the color to fill the screen with 🖌️ it must be given in RRGGBB, hex format. note there is no prepended # — i know, i know, no little hashtag, it's fine, it's fine 🙈 defaults to 000000.

💜 DESCRIPTION 💜

fills the specified outputs with the given color. literally so simple, so clean, so main character 💫

⚠️ currently, we do not cache this, so if you want a color to be set at initialization, you must set it every time:
awww-daemon && awww clear 1a804a

no cap, the "no caching" thing is real — there's no memory of your cute little color, so you gotta keep showing up for it every single time 😭 that's the commitment level.

🦋 SEE ALSO 🦋

that's the whole vibe check, bestie 💖 this page is from the General Commands Manual, awww-clear(1), dated 2026-05-07 — go paint something gorgeous with it 🍓🧚✨

📦 where this page comes from