mousetweaks(1)

mousetweaks1

Accessibility enhancements for pointing devices

Usage

mousetweaks [--dwell] [--ssc] [--dwell-time=FLOAT] [--ssc-time=FLOAT] [{-m | --dwell-mode=STRING}] [{-c | --show-ctw}] [{-t | --threshold=INT}] [{-g | --geometry}] [{-s | --shutdown}] [--daemonize] [{-? | --help}]

Overview

mousetweaks is a collection of accessibility enhancements for pointing devices. This manual page describes the mousetweaks daemon.

Options

--dwell

Automatically perform mouse clicks without using a physical button.

--ssc

Trigger the secondary mouse button when the primary mouse button is held down for a specified amount of time.

--dwell-time=FLOAT

Time to keep the pointer motionless before a dwell click is performed. Range: 0.2 - 3.0 seconds.

--ssc-time=FLOAT

Time to hold the primary mouse button before a simulated secondary click is performed. Range: 0.5 - 3.0 seconds.

-m, --dwell-mode=STRING

Select a dwell mode. Available options: window - Select the click type from a window or a panel applet. gesture - Perform different clicks by moving in different directions.

-c, --show-ctw

Show the click-type window. Only useful in combination with --dwell-mode=window.

-t, --threshold=INT

Ignore small pointer movements. Range: 0 - 30 pixels.

-g, --geometry

Size and position of the click-type window. Expects a standard X Window System geometry string. ie. WIDTHxHEIGHT+X+Y

-s, --shutdown

Stop the mousetweaks daemon.

--daemonize

Start mousetweaks in the background, ie. spawn a child process.

--login

Start mousetweaks in login mode. Login mode enables workarounds specific to GDM. Currently unused.

Files

mousetweaks.pid

The daemon creates a lock file in the $XDG_RUNTIME_DIR directory to keep track of its state. On systems with no user runtime directory, the $XDG_CACHE_HOME directory is used.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8–Arch

--daemonize since Debian 6.0 (Squeeze); --dwell since Debian 7 (Wheezy); --dwell-time since Debian 6.0 (Squeeze); --geometry since Debian 7 (Wheezy); --login since Debian 6.0 (Squeeze); --ssc since Debian 7 (Wheezy); --ssc-time since Debian 7 (Wheezy); --threshold since Debian 6.0 (Squeeze); -g since Debian 7 (Wheezy); -t since Debian 6.0 (Squeeze).

--ctw-x until Debian 6.0 (Squeeze); --ctw-y until Debian 6.0 (Squeeze); --disable-animation until Debian 6.0 (Squeeze); --enable until Debian 5.0 (Lenny); --enable-dwell until Debian 6.0 (Squeeze); --enable-secondary until Debian 6.0 (Squeeze); --secondary-time until Debian 6.0 (Squeeze); -e until Debian 5.0 (Lenny); -x until Debian 6.0 (Squeeze); -y until Debian 6.0 (Squeeze).

Bugs

Report bugs to <http://bugzilla.gnome.org/> ⟨http://bugzilla.gnome.org/⟩

Authors

This manual page was written by Francesco Fumanti.

License

Licenced under the GNU General Public License v3 or later.

From mousetweaks 3.32.0-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.