qshutdown(1)

<h1>🎀 qshutdown(1) — the glow-up guide 🎀</h1>

okay so bestie, you've opened the qshutdown page from the General Commands Manual and honestly? you're about to have the most organized shutdown of your life. no cap. let's get into it fr fr 💅

---

<h1>✨ NAME ✨</h1>

qshutdown — an advanced shutdown tool 👑

---

<h1>✨ SYNOPSIS ✨</h1>

qshutdown [options]

that's it. that's the whole vibe. 🦋

---

<h1>✨ DESCRIPTION ✨</h1>

so qshutdown is a simple tool that lets you pick a time or a number of minutes and then it'll shutdown, reboot, suspend or hibernate after that. literally choose your destiny.

and here's the drama: if there's less than 70 seconds left, qshutdown will show itself 3 times as a warning. iconic behavior honestly 😭 (but if 1 Minute or local time +1 Minute was set, it'll only appear once. she's efficient like that.)

this program uses qdbus to send a shutdown/reboot/suspend/hibernate request to either the gnome- or kde-session-manager, to HAL/ConsoleKit/DeviceKit/UPower, and if none of these work, the command 'sudo shutdown' will be used. it's giving ✨backup plan energy✨.

---

<h1>✨ OPTIONS ✨</h1>

• -h, --help — prints the options along with their descriptions. self care, bestie 🫶
• -i — prints information about qshutdown. the lore 💖
• -v — prints all errors and warnings. she's loud and honest and we love her 🌸

---

<h1>✨ NOTES ✨</h1>

⚠️ okay so important: when sending the request to HAL or ConsoleKit, or when the shutdown command is used, the Session will never be saved. and if the shutdown command is used, the program will only be able to shutdown and reboot. that's the whole menu. no more. 😭

if nothing happens when the shutdown- or reboot-time is reached, it means you're lowkey lacking the rights for the shutdown command 🙈. in that case you can do the following — post this in a terminal:

$ EDITOR=nano sudo -E visudo

and add this line:

* ALL = NOPASSWD:/sbin/shutdown

where * gets replaced by the username or %groupname. slay 💅

<h2>🛡️ For admins: 🛡️</h2>

if you want qshutdown to run with "parental lock" for every user, you can do:

$ sudo cp /usr/share/qshutdown/autostart/99qshutdown
/etc/X11/Xsession.d/

and set the option Lock_all in the root user's settings file to true. note that qshutdown has to start once to generate the settings file (she needs a lil warm-up, periodt). furthermore there is a need to do:

$ EDITOR=nano sudo -E visudo

and add the following line to the sudoers:

* ALL = NOPASSWD:/usr/bin/qshutdown

and if you should ever forget your set password? no panic bestie 💜 just remove the whole line starting with Password manually from the settings file. bye felicia 🌈

---

<h1>✨ FILES ✨</h1>

the configurationfile (and logfile) is located at ~/.qshutdown/ (under Linux/Unix). 📁✨

the maximum Number of countdown_minutes is 1440 (that's 24 hours, in case you were wondering — a full day of vibes 🕐).

---

<h1>✨ KNOWN ISSUES ✨</h1>

there is no system tray icon for qshutdown in Ubuntu 11.04. tragic. 😭

SOLUTION: type the following line in a terminal:

$ gsettings set com.canonical.Unity.Panel systray-whitelist "['all']"

for most systems using the Gnome Shell, a certain DBus method has been removed, thus a shutdown dialog will be likely to appear if qshutdown's methods have been set to automatic or to Gnome session. if you do not want this shutdown dialog to appear, please use ConsoleKit or something else. your girl is just telling you the facts 🙈

---

<h1>✨ HINTS ON USAGE ✨</h1>

if you want qshutdown to stop "bugging" you, just remove the hook from "warnings on?". silence her. respectfully. 🤫💖

---

<h1>✨ HOTKEYS ✨</h1>

• Ctrl+I — information window 🧚
• Ctrl+Q — Quit 👋
• Ctrl+P — Prefereces ✨
• Ctrl+L — write the run time once into the logfile (works only if qshutdown quits. To make it permanent set it in the preferences.) 📝
• Ctrl+S — set to shutdown 🔥
• Ctrl+R — set to restart 🔄
• Ctrl+U — set to suspend to RAM 💤
• Ctrl+H — set to hibernate 🛌
• Ctrl+E — stop timer (only if the countdown has started and the admin didn't restrict the access) ⏹️
• Shift+E — to edit the config file (for this a password is necessary. If you are a user, you can set an "empty password" (leave the password field empty)). 🔐

---

<h1>✨ AUTHOR ✨</h1>

Christian Metscher <hakaishi@web.de> — the legend herself 🫶💜

---

and that's the whole tea bestie!! 🍓 this page is from the qshutdown(1) manual, dated 2020-05-04. go forth, schedule your shutdowns, and stay iconic. mwah 💅💖✨