— run a
program on X inactivity
[-nw | -ne | -sw | -se]
extension to receive inactivity events when a timeout is specified, running a
specific program after the elapsed time. xidle
will also run the program if it is sent a
signal, or if the pointer sits in a
corner of the screen for an amount of time. Signal and corner locking are
always enabled, whether -timeout
is specified or
The options are as follows:
- Specify the size, in pixels, of the corner area. The
default is 2 pixels.
- Specify the number of seconds the pointer has to be in the
given position before running the program. The default is 2 seconds.
- This argument allows you to specify the server to connect
to; see X(7).
- Set the position to one of northwest, northeast, southwest,
or southeast, respectively. If no position is specified, the default is
- Specify the full pathname of the program to run on any of
the aforementioned events. Arguments to the program may also be specified,
separated by whitespace. If -program is not
specified, the default is
- Set the timeout to the specified number of seconds. If
-timeout is not specified,
xidle won't run any program on
A few sets of application specific resources are supported and their values can
be overriden by the command line options:
- Specify the size, in pixels, of the corner area; see the
- Specify the number of seconds to wait before running the
program; see the -delay option.
- Set the position to one of: "nw", "ne",
"sw", or "se"; see descriptions of the
-sw, and -se
- Specify the full pathname of the program to run; see the
- Set the timeout to the specified number of seconds; see the
program resource class is
flying bats mode if no activity is detected in 300 seconds or the pointer sits
in the southwest corner for more than 5 seconds:
$ xidle -delay 5 -sw -program "/usr/X11R6/bin/xlock -mode bat" \
program was written by Federico Schwindt
as an xautolock replacement.
The maximum number of arguments for -program
including the executable file, is currently set to 9.