README
1MouseTool is a program that clicks the mouse for you.
2
3I designed it to help relieve the pain that clicking mouse buttons can cause.
4
5For more information, see www.mousetool.com
6
7
8How To Use MouseTool
9
101 It's simple: MouseTool watches as you move the mouse. When you stop, it clicks.
11
122 Practice with this. When you are comfortable with it, move on to Smart Drag.
13
143 When Smart Drag is enabled, MouseTool pauses after it clicks down. If you
15 move the mouse, it waits until you stop moving before it clicks up.
16 This takes more practice, but if I can learn to do it without thinking, so can you.
17
184 KMouseTool 1.1 supports strokes. When you enable strokes, a slow move to the
19 right and back, followed by a pause, will generate a right-click. A slow move
20 left and back will generate a double click. (Strokes are specified in
21 ~/.kde3/share/config/kmousetool_strokes.txt. This file is generated by KMouseTool
22 the first time it is run, but can be modified afterwards.)
23
24MouseTool Options:
25
26* Checkboxes:
27 Smart Drag -- enables or disables Smart Drag. Disabled is easier, so this is default.
28 Audible Click -- plays a sound when MouseTool clicks down. This helps, especially
29 with Smart Drag, but as of version 0.8, the latency is too high.
30 By the time you hear the click, you're doing something else.
31 This will be fixed in the next version.
32 Start with desktop session
33 -- When this is enabled, MouseTool will start each time the desktop session
34 starts.
35 Enable Strokes -- When this is enabled, you can generate right- or double-clicks
36 using mouse strokes.
37
38* Times
39 Dwell Time -- The time you have to pause before MouseTool clicks.
40 Drag Time -- (When Smart Drag is enabled) the time MouseTool waits, after it clicks
41 down, before it clicks back up if you don't move the mouse.
42 Apply Times Button -- After changing either time, you must click this button.
43
44* Start Button -- Starts MouseTool. (Well, duh.)
45 When it says "stop", clicking it will stop MouseTool. (Duh, again.)
46
47* command line -- MouseTool has no command line options.
48 It does remembers its state when it is restarted, though.
49
50* Hotkeys -- None yet (as of version 1.1). They are very useful, though, and may be added.
51
52
53Credit:
54
55The idea for MouseTool came to me when I was thinking about head-tracking
56systems that allow you to move a cursor using your head orientation, and then
57send clicks when you pause. As far as I know, I was the first person to use
58this technique with an ordinary mouse, but it is quite possible that I am wrong
59about that. There are now other programs available for Windows and Macs that
60do this; I know that some were developed after MouseTool, but it is likely
61others came before.
62
63If you know of another Linux- or Unix-based program that does this, please let
64me know (at jeff@mousetool.com)
65
66The clever idea for Smart Drag was suggested by Joe Betts. Thanks, Joe!
67
68Other ideas in MouseTool for Windows that I hope to port to KDE were either
69suggested by MouseTool users or came out of email discussions with users.
70
71
72
73Bugs and issues:
74Emacs - Smart Drag and Emacs menus don't mix well; the menus don't stay visible
75 long enough to use. XEmacs seems to work fine. Gvim also works well.
76
77Taskbar - When you drag the taskbar using Smart Drag in KDE 2.x, kmousetool won't release
78 the drag. This can be scary if you're not expecting it, but simply clicking
79 the mouse button manually fixes the problem. KDE 3.x does not have this problem.
80
81 This seems to be an issue with the internals of KDE or QT code, and similar
82 things happen in Windows. I haven't looked into it much under KDE, but on
83 Windows it happens when mousetool's timer stops while Windows waits for an
84 upclick, and the upclick never happens because the timer is stopped;
85 I'm sure the same thing is happening under KDE.
86