From 8fbafbfab5671d56dd469f2205b7906c4a7f7c7c Mon Sep 17 00:00:00 2001 From: Mattias Eriksson Date: Tue, 17 Apr 2018 09:54:02 +0200 Subject: Idle handling for dpms/lockscreen et al Swayidle handles idle events and allows for dpms and lockscreen handling. It also handles systemd sleep events, and can raise a lockscreen on sleep Fixes #541 --- swayidle/swayidle.1.scd | 61 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 swayidle/swayidle.1.scd (limited to 'swayidle/swayidle.1.scd') diff --git a/swayidle/swayidle.1.scd b/swayidle/swayidle.1.scd new file mode 100644 index 00000000..5cd4a7fd --- /dev/null +++ b/swayidle/swayidle.1.scd @@ -0,0 +1,61 @@ +swayidle (1) + +# NAME + +swayidle - Idle manager for Wayland + +# SYNOPSIS + +*swayidle* [options] [events...] + +# OPTIONS + +*-h* + Show help message and quit. + +*-d* + Enable debug output. + +# DESCRIPTION + +swayidle listens for idle activity on your Wayland compositor and executes tasks +on various idle-related events. You can specify any number of events at the +command line. + +# EVENTS + +*timeout* [resume ] + Execute _timeout command_ if there is no activity for seconds. + + If you specify "resume ", _resume command_ will be run when + there is activity again. + +*before-sleep* + If built with systemd support, executes _command_ before systemd puts the + computer to sleep. + +All commands are executed in a shell. + +# EXAMPLE + +``` + swayidle \ + timeout 300 'swaylock -c 000000' \ + timeout 600 'swaymsg "output * dpms off"' \ + resume 'swaymsg "output * dpms on"' \ + before-sleep 'swaylock -c 000000' +``` + +This will lock your screen after 300 seconds of inactivity, then turn off your +displays after another 600 seconds, and turn your screens back on when resumed. +It will also lock your screen before your computer goes to sleep. + +# AUTHORS + +Maintained by Drew DeVault , who is assisted by other open +source contributors. For more information about sway development, see +https://github.com/swaywm/sway. + +# SEE ALSO + +*sway*(5) *swaymsg*(1) *swaygrab*(1) *sway-input*(5) *sway-bar*(5) -- cgit v1.2.3-54-g00ecf