NAME

xclickroot — run command on button press on root window

SYNOPSIS

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)