XSSPROXY(1)

📦
version 1.1.2 · 2 versions
, in nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💅 XSSPROXY — the xssproxy(1) page, but make it make sense ✨

okay bestie, welcome to the General Commands Manual section, entry XSSPROXY(1). this is the whole lore, no skips, let's go 🦋

🌸 NAME 🌸

xssproxy — forward freedesktop.org Idle Inhibition Service calls to Xss

like, it's the little middle-man messenger between the fancy desktop apps and your X11 screensaver. iconic behavior honestly 💖

✨ SYNOPSIS ✨

xssproxy [-v] [-i APP]

that's it. that's the whole vibe check. two optional flags, one little program 🎀

🫶 DESCRIPTION 🫶

so here's the tea, bestie: xssproxy implements the org.freedesktop.ScreenSaver D-Bus interface, exactly as it's described in the Idle Inhibition Service Draft by the freedesktop.org developers. (iykyk — that's the spec everyone follows.)

and then the actual inhibition of the screensaver? that part gets controlled using the XScreenSaverSuspend function from the Xss library — aka the X11 Screen Saver extension. so it's giving translator: D-Bus on one side, Xss on the other, xssproxy in the middle holding both hands 🌈

💅 OPTIONS 💅

  • -v, --verbose — print messages when receiving inhibition requests. like, it'll actually tell you what's going on instead of being mysterious and silent 👀
  • -i, --ignore — do not disable the screensaver for this application. pass "*" to ignore all applications. so if some app is being annoying with its inhibition requests, you just tell it "not today" 🙈

⭐ a little bonus flag ⭐

  • --version — print version information and exit. quick little "who am I" moment, then it dips 👑

🌼 EXAMPLES 🌼

to use it, run it in your ~/.xinitrc file. heads up tho: the program doesn't return, so you need to run it in the background. no cap, it just keeps living there 🧚

xssproxy &

that & is doing the heavy lifting, don't forget it 💀

👑 AUTHOR 👑

Written by Tim Schumacher. (we stan, thank you for the code 🫶)

😭 REPORTING BUGS 😭

Report bugs at the GitHub issue tracker:

<https://github.com/vincentbernat/xssproxy/issues>

if something's cursed, go tell them fr fr. they want to know 💜

and that's the whole page bestie — this was the XSSPROXY(1) manual page from the General Commands Manual, and yeah, the footer is literally just XSSPROXY(1) again because the manual name stays iconic at the bottom too 🎀✨ slay, go suspend some screensavers (or don't, respectfully) 💖

📦 where this page comes from