XCLICKROOT(1)

NAME
xclickroot - run command on button press on root window

SYNOPSIS
xclickroot [-12345lmr] command [arg ...]

DESCRIPTION
xclickroot runs a command when a given mouse button is pressed on the root window. The arguments command and arg ... are the command to be run and its arguments.

By default, the command is run when the right mouse button is pressed on the root window. This can be changed by one of the following options.

-1 | -l
    Use the left mouse button.

-2 | -m
    Use the middle mouse button.

-3 | -r
    Use the right mouse button.

-4  Use scroll up.

-5  Use scroll down.

ENVIRONMENT
The following environment variables affect the execution of xclickroot.

DISPLAY
    The display to start xclickroot on.

EXAMPLES
xclickroot is most commonly invoked at ~/.xinitrc or ~/.xsession (or any other script starting up a X(7) session) in background, before the window manager, as follows:

    xclickroot -l xterm &

That will invoke xterm(1) whenever the user clicks on the root window with the left mouse button.

SEE ALSO
X(7)