MirOS Manual: xidle(1)

XIDLE(1)                     BSD Reference Manual                     XIDLE(1)

NAME

     xidle - run a program on X inactivity

SYNOPSIS

     xidle [-area pixels] [-delay secs] [-display display] [-nw | -ne | -sw |
           -se] [-program path] [-timeout secs]

DESCRIPTION

     xidle uses the XScreenSaver(3) extension to receive inactivity events
     when a timeout is specified, running a specific program after the elapsed
     time. xidle also monitors the very corner of the given position for
     pointer activity and runs a program if the pointer sits there for more
     than the specified number of seconds. This behavior is always present,
     whether -timeout is specified or not.

     The options are as follows:

     -area pixels
              Specify the size in pixels of the corner area. The default is 2
              pixels.

     -delay secs
              Specify the number of seconds the pointer has to be in the given
              position before running the program. The default is 2 seconds.

     -display display
              This argument allows you to specify the server to connect to;
              see X(7).

     -nw | -ne | -sw | -se
              Set the position to one of northwest, northeast, southwest, or
              southeast, respectively. If no position is specified, the de-
              fault is northwest.

     -program path
              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 speci-
              fied, the default is xlock(1).

     -timeout secs
              Set the timeout to the specified number of seconds. If -timeout
              is not specified, xidle won't run any program on inactivity.

EXAMPLES

     Run xlock(1) using the 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" \
                   -timeout 300

SEE ALSO

     xlock(1), XScreenSaver(3), X(7)

AUTHORS

     The xidle program was written by Federico Schwindt as an xautolock re-
     placement.

BUGS

     xidle does not support resources (yet).

     The maximum number of arguments for -program, including the executable
     file, is currently set to 9.

MirOS BSD #10-current           July 29, 2013                                1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.