
Copyright © 2002 Jeff Roush
KMouseTool clicks the mouse whenever the mouse cursor pauses briefly. It was designed to help those with repetitive strain injuries, for whom pressing buttons hurts.
Table of Contents

KMouseTool clicks the mouse whenever the mouse cursor pauses briefly. It was designed to help those with repetitive strain injuries, for whom pressing buttons hurts. It can also drag the mouse, although this takes a bit more practice.
KMouseTool can eliminate the pain caused by clicking the mouse, and helps many people to use the computer without pain. Unfortunately, some pain can also be caused by simply moving the mouse around the table. If you are experiencing computer-related pain and haven't yet seen a doctor, please do so.
Just to make it absolutely clear: while KMouseTool can help reduce the pain caused by clicking the mouse, it cannot help any pain caused by moving the mouse. And, like all ergonomic tools, your mileage may vary.

Using KMouseTool is simple: KMouseTool watches as you move the mouse, and when you pause briefly, it clicks.
KMouseTool's Smart Drag mode allows you to drag the mouse.
When Smart Drag is enabled, KMouseTool pauses after it clicks down; if you move the mouse, it waits until you stop moving before it clicks up. This way, you can both click and drag the mouse. Smart Drag takes a bit more practice, but becomes natural once you get used to it.

KMouseTool's options are accessed mostly via the mouse.
- /
Starts (or stops) KMouseTool.
- Minimum movement:
The minimum movement in pixels before KMouseTool will attempt to click the mouse.
- Dwell time (1/10 sec):
The time the mouse has to pause before KMouseTool clicks. Try increasing this time if it is hard getting used to KMouseTool
- Smart drag
Enables or disables Smart Drag. Disabled use is easier, so this is the default.
If you enable Smart drag the Drag time (1/10 sec): field becomes available. This is the time KMouseTool waits, after it clicks down, before it clicks back up if you don't move the mouse.
- Enable strokes
KMouseTool now supports strokes. When you enable strokes, a slow move to the right and back, followed by a pause, will generate a click. A slow move left and back will generate a double click. (Strokes are specified in
$
. This file is generated by KMouseTool the first time it is run, but can be modified afterwards.)KDEHOME
/share/config/kmousetool_strokes.txt- Audible click
Plays a sound when KMouseTool clicks down. This helps, especially with Smart Drag.
- Start with desktop session
When this is enabled, KMouseTool will start each time the session of the desktop starts.
Reset all settings to their defaults.
Reset all settings to their state when you opened the dialog, or, if you have already saved a setting with the button, reset all settings to the state when you last pressed
After changing any settings, you must click this button.
Opens the User manual (this document).
Close the dialog without saving any settings.
Quit KMouseTool

These tips can help shorten KMouseTool's learning curve a bit.
You can modify the time delays KMouseTool waits, for both clicking and for dragging.
It's best to practice clicking with KMouseTool using its defaults first. You may especially want to leave Smart Drag disabled at first. Then, once you are comfortable clicking, move on to practicing Smart Drag.
When using Smart Drag, it may help to enable the Audible Click
When using the Audible Click, you may need to speed up KDE's audio response.

- 5.1. Help! KMouseTool keeps dropping spurious clicks all over the screen!
- 5.2. My mouse sticks when I move it. Can I still use KMouseTool?
- 5.3. KMouseTool clicks down and never clicks up. What's happening?
- 5.4. KMouseTool moves the cursor when I am trying to type.
- 5.5. I'm trying to use Smart Drag, but I cannot get the hang of using it to edit text.

KMouseTool
Program copyright 2002 Jeff Roush (jeff AT mousetool.com)
and 2003 Gunnar Schmi Dt (gunnar AT schmi-dt.de)
Contributors:
Jeff Roush
(jeff AT mousetool.com)
Gunnar Schmi Dt
(gunnar AT schmi-dt.de)
Olaf Schmidt
(ojschmidt AT kde.org)
Documentation copyright 2002 Jeff Roush (jeff AT mousetool.com)
This documentation is licensed under the terms of the GNU Free Documentation License.
This program is licensed under the terms of the GNU General Public License.