HYPRSHUTDOWN(1)

💖 HYPRSHUTDOWN(1) 💖

okay bestie, so this is the manual page for hyprshutdown — a graceful shutdown utility for Hyprland — living in the General Commands Manual</> / User Commands</> section (section 1, iykyk). let's get into it 🫶

---

✨ NAME ✨

hyprshutdown — graceful shutdown utility for Hyprland 🌸

---

✨ SYNOPSIS ✨

hyprshutdown [OPTION]...

---

✨ DESCRIPTION ✨

so hyprshutdown is a graceful shutdown utility for the Hyprland Wayland compositor. it pops open a GUI dialog and, like, politely asks all your running apps to exit — then quits Hyprland. no drama, no chaos, just vibes 💅

this is the recommended way to exit Hyprland, fr fr. if you use other methods (looking at you, dispatch exit) your applications get forcefully killed instead of being given the opportunity to exit cleanly. and not to be dramatic but that's giving crash energy 😭

---

✨ OPTIONS ✨

• --vt N — switch to virtual terminal N after Hyprland exits. super useful on NVIDIA + SDDM systems to prevent a black screen or a hang on logout 👑
• --dry-run — show the shutdown UI without actually closing any applications or exiting Hyprland. a little dress rehearsal, no consequences 🎀
• --no-exit — close applications gracefully but do not exit Hyprland afterwards 🦋
• --top-label, -t TEXT — set custom text to display at the top of the shutdown dialog ✨
• --post-cmd, -p COMMAND — run COMMAND after Hyprland has exited. can be used to power off or reboot the system 🔥
• --no-fork — run in the foreground instead of daemonizing 🌸
• --verbose — enable debug logging. for when you need to know everything 💀
• --help, -h — show a help message and exit 🙈

---

✨ EXAMPLES ✨

log out of Hyprland:

hyprshutdown

shut the system down after closing apps:

hyprshutdown -t 'Shutting down...' --post-cmd 'shutdown -P 0'

reboot the system after closing apps:

hyprshutdown -t 'Restarting...' --post-cmd 'reboot'

preview the dialog without doing anything:

hyprshutdown --dry-run

---

✨ NVIDIA + SDDM USERS ✨

okay this one's for the NVIDIA + SDDM girlies specifically 💜 if you experience a black screen or a hang when logging out with an NVIDIA GPU and the SDDM display manager, use the --vt flag to force a virtual terminal switch after exit:

hyprshutdown --vt 2

SDDM typically runs on VT2 — so check your system configuration if you need a different terminal. no guessing, bestie 🎀

the VT switch is performed via chvt(1) and it requires passwordless sudo access for that command. to configure this, run:

echo "$USER ALL=(ALL) NOPASSWD: /usr/bin/chvt" | sudo tee /etc/sudoers.d/chvt
sudo chmod 440 /etc/sudoers.d/chvt

this is considered safe because chvt only switches virtual terminals and cannot be exploited for privilege escalation. slay 💅

⚠️ reminder bestie: that sudoers setup is what makes the --vt switch work at all. no passwordless chvt, no auto VT switch. periodt.

---

✨ SEE ALSO ✨

hyprland(1), chvt(1), shutdown(8), reboot(8) 🌈

---

✨ AUTHORS ✨

this manual page was written for the Debian project based on the Hyprland wiki at https://wiki.hyprland.org. 🫶

---

aaaand that's the whole page, bestie — hyprshutdown(1), section 1, shipped under the General Commands Manual</> / User Commands</> umbrella as part of Debian's manual pages. go forth and log out gracefully, you main character 💖✨🎀