awww-clear-cache(1)

🦋 awww-clear-cache — from the General Commands Manual, bestie 💅

okay so real quick: this is the man page for awww-clear-cache, and yes it lives in the General Commands Manual section because it's a whole command, not some library thing. let's get into it ✨

---

💖 NAME 💖

awww-clear-cache — the little command that wipes your awww cache. that's the whole personality. no cap. 🧹

---

🌸 SYNOPSIS 🌸

awww clear-cache

that's it. that's the whole invocation. go off, king 👑

---

🎀 OPTIONS 🎀

• -h, --help — prints the help text 🫶. and ngl, -h gives you the summary version — the short and sweet one — so if you want the whole lore, that's a different vibe (it literally says "see a summary with '-h'").

---

🔥 DESCRIPTION 🔥

okay so what does it actually do? it deletes the awww cache directory. periodt. 💀

the cache lives at $XDG_CACHE_HOME/awww — or, if $XDG_CACHE_HOME doesn't exist, it's at $HOME/.cache/awww. two homes, one cache, we love options ✨

inside that directory, awww creates another directory — and this one corresponds to awww's current version number. cute, very versioned of it 🎀 inside that one you'll find the files that cache the last displayed image, plus the animation frames for animated wallpapers. and bestie, there's one file per output — every output gets its own little cache file. iconic behavior honestly 🌈

⚠️ important note so you're not surprised: awww will automatically delete any files and directories in $XDG_CACHE_HOME/awww that do not correspond to the exact current awww version number. why? to make sure we only ever keep cache files for the latest awww version. so old-version leftovers? gone. not me being tidy 💅

---

🦋 SEE ALSO 🦋

• awww-img(1) — go check that one out too, iykyk 💜

---

okay that's the whole page! 🫶 this gem is dated 2026-05-07, and it comes to you straight from the General Commands Manual — so like, official manual energy 👑 go clear that cache, bestie, and slay the day ⭐💖