diff options
author | dakkar <dakkar@thenautilus.net> | 2021-05-01 10:48:04 +0100 |
---|---|---|
committer | dakkar <dakkar@thenautilus.net> | 2021-05-01 10:48:57 +0100 |
commit | 06563b95754156d8803d7dae47d1737985886a55 (patch) | |
tree | 9f7ff5b6d5de88a74397ca041403ef55d7b79e90 /scripts/xscreensaver-dbus | |
parent | name, bump year & version (diff) | |
download | xscreensaver-dbus-06563b95754156d8803d7dae47d1737985886a55.tar.gz xscreensaver-dbus-06563b95754156d8803d7dae47d1737985886a55.tar.bz2 xscreensaver-dbus-06563b95754156d8803d7dae47d1737985886a55.zip |
pod
Diffstat (limited to 'scripts/xscreensaver-dbus')
-rwxr-xr-x | scripts/xscreensaver-dbus | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/scripts/xscreensaver-dbus b/scripts/xscreensaver-dbus index 5e188f2..98e61c9 100755 --- a/scripts/xscreensaver-dbus +++ b/scripts/xscreensaver-dbus @@ -3,6 +3,51 @@ use strict; use warnings; use Log::Any::Adapter Stdout => ( log_level => 'debug' ); use App::XScreenSaver::DBus; +# VERSION +# PODNAME: xscreensaver-dbus +# ABSTRACT: tie xscreensaver into dbus $|++; App::XScreenSaver::DBus->new->run; + +=head1 SYNOPSIS + + xscreensaver & + xscreensaver-dbus > ~/xscreensaver-dbus.log & + +=head1 DESCRIPTION + +This program will ensure that xscreensaver locks the screen before +your laptop goes to sleep, and will prevent the screen saver from +running while video is playing. + +It does so by implementing L<the "idle inhibition" DBus +service|https://people.freedesktop.org/~hadess/idle-inhibition-spec/index.html> +and using L<the "inhibitor locks" feature of +logind|https://www.freedesktop.org/wiki/Software/systemd/inhibit/>. + +=head1 WHY? + +If you use xscreensaver, you may have noticed that it doesn't +integrate very well with all the new & fancy desktop features. + +jwz has resisted adding this kind of integration to the base program, +saying (sensibly) that they would bloat the code and introduce +potential security holes. + +From version 5.43, xscreensaver includes F<xscreensaver-systemd>, a +stripped-down version of L<a program initially developed by Martin +Lucina|https://github.com/mato/xscreensaver-systemd>, which handles +the logind interaction. Both of those versions link to F<libsystemd>, +which you may not have if you use elogind instead of the full systemd. + +So I wrote this. + +=head1 REFERENCES + +=for :list +* Martin Lucina F<xscreensaver-systemd> https://github.com/mato/xscreensaver-systemd +* the Debian bug where the above program is first mentioned https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=781961 +* "Is there a decent way to inhibit screensavers in linux?" on StackOverflow https://stackoverflow.com/questions/460140/is-there-a-decent-way-to-inhibit-screensavers-in-linux +* the systemd "Inhibitor Locks" documentation https://www.freedesktop.org/wiki/Software/systemd/inhibit/ +* the "idle inhibition" spec https://people.freedesktop.org/~hadess/idle-inhibition-spec/index.html |