BUDGIE-SESSION-INH(1)

πŸ’– BUDGIE-SESSION-INH(1) πŸ’–

okay bestie, welcome to the budgie-session-inhibit page, section 1 of the user commands manual, brought to you by budgie-session itself. pull up a chair, grab a boba, we're doing Unix 🫢


✨ NAME ✨

budgie-session-inhibit β€” inhibit budgie-session functionality


🌸 SYNOPSIS 🌸

budgie-session-inhibit [OPTION...] [COMMAND]

πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the vibe: budgie-session-inhibit can inhibit certain budgie-session functionality while it's executing the COMMAND you gave it. the way it does this?? it calls the Inhibit() method of the budgie-session D-Bus API and creates an inhibitor. and the best part β€” that inhibitor is automatically removed when budgie-session-inhibit exits. no cleanup, no leftovers, no mess. slay πŸ’…

a typical use case, since I know you're gonna ask: preventing the session from going idle (and thus locking the screen πŸ”’) while a movie player is running. yes bestie, that means you can watch your 4-hour video essay without your screen locking every five minutes. iconic behavior honestly.


πŸŽ€ OPTIONS πŸŽ€

  • -h, --help β€” print help and exit. the classic. the goat. πŸ™Œ
  • --version β€” print version information and exit.
  • --app-id ID β€” the application id to use when calling the budgie-session Inhibit() method. if you don't specify this option, "unknown" is used. (yes, literally the string unknown, no cap.)
  • --reason REASON β€” a human-readable reason to pass along when calling the budgie-session Inhibit() method. if you don't specify this option, "not specified" is used. give it a cute reason, it deserves one πŸ₯Ί
  • --inhibit ARG β€” ARG specifies the things to inhibit, as a colon-separated list. the possible values are logout, switch-user, suspend, idle, automount. if this option is used more than once, the values are combined. if you don't specify this option at all, idle is assumed. so it's giving "pick your fighter, or several, or just vibe with the default" πŸ’€
  • --inhibit-only β€” do not launch COMMAND and wait forever instead. yes, forever. forever-ever. 🌈
  • -l, --list β€” list the existing inhibitions and exit. window shopping, but for inhibitors πŸ›οΈ

⭐ SEE ALSO ⭐

systemd-inhibit(1) β€” the cousin, the relative, the family member. go say hi πŸ‘‘


lowkey reminder bestie: the inhibitor goes poof the second budgie-session-inhibit exits, so don't go expecting it to hang around after you're done. that's the whole point πŸ’–

and that's the page!! this lil' manual lives under the source budgie-session and is page BUDGIE-SESSION-INH(1) β€” tysm for reading, go inhibit something (responsibly) πŸ’…βœ¨πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from