aboutsummaryrefslogtreecommitdiffstats
path: root/swayidle/swayidle.1.txt
blob: a32e6fd552bd78aee3fd3c745affcd736586268b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
/////
vim:set ts=4 sw=4 tw=82 noet:
/////
:quotes.~:

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* <timeout> <timeout command> [resume <resume command>]::
	Execute <timeout command> if there is no activity for <timeout> seconds.
	+
	If you specify "resume <resume command>", <resume command> will be run when
	there is activity again.

*before-sleep* <command>::
	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 <sir@cmpwn.com>, who is assisted by other open
source contributors. For more information about sway development, see
<https://github.com/swaywm/sway>.