Warning, /accessibility/kmousetool/README is written in an unsupported language. File is not indexed.
0001 MouseTool is a program that clicks the mouse for you. 0002 0003 I designed it to help relieve the pain that clicking mouse buttons can cause. 0004 0005 For more information, see www.mousetool.com 0006 0007 0008 How To Use MouseTool 0009 0010 1 It's simple: MouseTool watches as you move the mouse. When you stop, it clicks. 0011 0012 2 Practice with this. When you are comfortable with it, move on to Smart Drag. 0013 0014 3 When Smart Drag is enabled, MouseTool pauses after it clicks down. If you 0015 move the mouse, it waits until you stop moving before it clicks up. 0016 This takes more practice, but if I can learn to do it without thinking, so can you. 0017 0018 4 KMouseTool 1.1 supports strokes. When you enable strokes, a slow move to the 0019 right and back, followed by a pause, will generate a right-click. A slow move 0020 left and back will generate a double click. (Strokes are specified in 0021 ~/.kde3/share/config/kmousetool_strokes.txt. This file is generated by KMouseTool 0022 the first time it is run, but can be modified afterwards.) 0023 0024 MouseTool Options: 0025 0026 * Checkboxes: 0027 Smart Drag -- enables or disables Smart Drag. Disabled is easier, so this is default. 0028 Audible Click -- plays a sound when MouseTool clicks down. This helps, especially 0029 with Smart Drag, but as of version 0.8, the latency is too high. 0030 By the time you hear the click, you're doing something else. 0031 This will be fixed in the next version. 0032 Start with desktop session 0033 -- When this is enabled, MouseTool will start each time the desktop session 0034 starts. 0035 Enable Strokes -- When this is enabled, you can generate right- or double-clicks 0036 using mouse strokes. 0037 0038 * Times 0039 Dwell Time -- The time you have to pause before MouseTool clicks. 0040 Drag Time -- (When Smart Drag is enabled) the time MouseTool waits, after it clicks 0041 down, before it clicks back up if you don't move the mouse. 0042 Apply Times Button -- After changing either time, you must click this button. 0043 0044 * Start Button -- Starts MouseTool. (Well, duh.) 0045 When it says "stop", clicking it will stop MouseTool. (Duh, again.) 0046 0047 * command line -- MouseTool has no command line options. 0048 It does remembers its state when it is restarted, though. 0049 0050 * Hotkeys -- None yet (as of version 1.1). They are very useful, though, and may be added. 0051 0052 0053 Credit: 0054 0055 The idea for MouseTool came to me when I was thinking about head-tracking 0056 systems that allow you to move a cursor using your head orientation, and then 0057 send clicks when you pause. As far as I know, I was the first person to use 0058 this technique with an ordinary mouse, but it is quite possible that I am wrong 0059 about that. There are now other programs available for Windows and Macs that 0060 do this; I know that some were developed after MouseTool, but it is likely 0061 others came before. 0062 0063 If you know of another Linux- or Unix-based program that does this, please let 0064 me know (at jeff@mousetool.com) 0065 0066 The clever idea for Smart Drag was suggested by Joe Betts. Thanks, Joe! 0067 0068 Other ideas in MouseTool for Windows that I hope to port to KDE were either 0069 suggested by MouseTool users or came out of email discussions with users. 0070 0071 0072 0073 Bugs and issues: 0074 Emacs - Smart Drag and Emacs menus don't mix well; the menus don't stay visible 0075 long enough to use. XEmacs seems to work fine. Gvim also works well. 0076 0077 Taskbar - When you drag the taskbar using Smart Drag in KDE 2.x, kmousetool won't release 0078 the drag. This can be scary if you're not expecting it, but simply clicking 0079 the mouse button manually fixes the problem. KDE 3.x does not have this problem. 0080 0081 This seems to be an issue with the internals of KDE or QT code, and similar 0082 things happen in Windows. I haven't looked into it much under KDE, but on 0083 Windows it happens when mousetool's timer stops while Windows waits for an 0084 upclick, and the upclick never happens because the timer is stopped; 0085 I'm sure the same thing is happening under KDE.