awww-query(1)

💖 awww-query(1) — the query page, bestie edition 💖

okay so real talk, this is the manual page for awww-query, and it's genuinely one of the cutest little commands in the whole awww family. no cap. let's get into it 🫶

---

✨ SYNOPSIS ✨

awww query

that's it. that's the whole invocation. she's low maintenance 💅

---

🌸 OPTIONS 🌸

• -a, --all — sends this command to every active awww-daemon namespace. all of them. the whole group chat gets the message 📢
• -j, --j — prints the info in json format. yes, the flag really is just --j. iconic honestly, we don't question it ✨
• -n, --namespace <namespace> — which wayland namespace you wanna send this command to.

you can drop this option multiple times to fire commands at multiple namespaces all at once, like so: awww query -n <namespace1> -n <namespace 2>. multitasking queen 👑

this changes the name of the awww-daemon socket we use to talk to the daemon. specifically, our socket name is ${WAYLAND_DISPLAY}-awww-daemon.<specified namespace>.socket — that's the exact string, don't come for me 🎀

some compositors can have several different wallpapers per output, and this option is how you tell them apart. most users will probably never need to set anything in here, so if that's you, you can chill 💀

• -h, --help — prints help (see a summary with -h). your classic little helper fairy 🧚

---

🦋 DESCRIPTION 🦋

she asks the daemon to print out the output information — that's the names and the dimensions. literally just "hey bestie, what outputs do we have and how big are they" and the daemon goes off 💖

you can use this to find out the valid values for the <awww-img --outputs> option. and if you want more detailed info about your outputs? honestly I'd recommend trying something like wlr-randr. different tool, different vibe, still slays ✨

---

🌈 OUTPUT FORMAT 🌈

right now, awww query prints info in exactly this format:

NAMESPACE: OUTPUT: SIZE, scale: SCALE, currently displaying: IMAGE_OR_COLOR

where SIZE is in the WxH format (eg.: 1920x1080), SCALE sits inside "scale: NUMBER", and IMAGE_OR_COLOR is either:

• "image: IMAGENAME", if it's an image; or
• "color: RGB", if it's a color

two moods, one field 💅

---

👑 JSON FORMAT 👑

the json format prints information like so:

{
"NAMESPACE": [<LIST OF OUTPUTS>]
}

where each output in that list looks like this:

{
     "name": <NAME>,
     "width": <WIDTH>,
     "height": <HEIGHT>,
     "scale": <SCALE>,
     "displaying": {
          "image" OR "color": <PATH/TO/IMAGE> OR <COLOR IN HEXA>
     },
}

note the "image" OR "color" key situation — it's whichever one applies, and the value is either <PATH/TO/IMAGE> or <COLOR IN HEXA>. structured data era fr fr 🍓

---

heads up bestie: that trailing comma in the object? it's in the manual exactly like that. I'm not here to fix it, I'm here to report it. 🙈

---

kisses, this page is from the General Commands Manual, version-dated 2026-05-07, and it goes by awww-query(1) — go forth and query your little heart out, ily, bye 💜🦋🌸