ICEWM-SHUTDOWN(5)

💅 icewm-shutdown(5) — the goodbye-notes file, bestie

okay so real talk: this is the icewm-shutdown(5) manual, and it's literally the last words your icewm session says before it dips. think of it as the group-chat "ok byeee 👋" message but, like, executable.

---

✨ NAME ✨

icewm-shutdown — the icewm shutdown configuration file. that's it, that's the whole vibe. it's the config file that holds the commands for when icewm shuts down 🎀

---

🦋 SYNOPSIS 🦋

these are the spots it can live, bestie:

$ICEWM_PRIVCFG/shutdown
$XDG_CONFIG_HOME/icewm/shutdown
$HOME/.icewm/shutdown
/usr/etc/icewm/shutdown
/usr/share/icewm/shutdown

---

🌸 DESCRIPTION 🌸

so this file contains the commands that get executed on icewm shutdown. it's an executable script — like, actually a script, not just a list of vibes — full of commands that run in the last stage of icewm termination 🔥

typically they undo some of the effects of the startup script. y'know, cleanup era. closing the loop. the way that startup does a thing and shutdown un-does the thing? iconic behaviour tbh.

it gets run by icewm-session(1) when icewm terminates. so icewm-session is the one calling the shots here, not you. 💅

---

🎀 FILES 🎀

locations for the shutdown file are as follows:

$ICEWM_PRIVCFG/shutdown
$XDG_CONFIG_HOME/icewm/shutdown
$HOME/.icewm/shutdown
/usr/etc/icewm/shutdown
/usr/share/icewm/shutdown

the locations are searched in the order listed; the first file found is read and the remainder ignored. so it's giving "first come, first served" — once it finds one, the rest are literally chopped, not read at all 🙈

---

👑 SEE ALSO 👑

• icewm-session(1)
• icewm-startup(5)

go read those too, iykyk 🫶

---

🧚 AUTHOR 🧚

Brian Bidulock <mailto:bidulock@openss7.org> — king behaviour, ty for the manpage 💜

---

⭐ LICENSE ⭐

IceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution. no cap, go read the COPYING file if you need the deets 📜

---

lowkey important: this is an executable script, so it actually runs. don't put random chaos in there unless you truly mean it, bestie 😭

---

and that's the whole page, mwah 💖 this was icewm-shutdown(5) from icewm 4.1.0, dated 2026-08-06 — slay, bye ✨🦋