kmousetool/README

   1 MouseTool is a program that clicks the mouse for you.
   2
   3 I designed it to help relieve the pain that clicking mouse buttons can cause.
   4
   5 For more information, see www.mousetool.com
   6
   7
   8 How To Use MouseTool
   9
  10 1 It's simple: MouseTool watches as you move the mouse. When you stop, it clicks.
  11
  12 2 Practice with this.  When you are comfortable with it, move on to Smart Drag.
  13
  14 3 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
  18 4 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
  24 MouseTool 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 KDE     -- When this is enabled, MouseTool will start each time KDE starts.
  33   Enable Strokes     -- When this is enabled, you can generate right- or double-clicks
  34                         using mouse strokes.
  35
  36 * Times
  37   Dwell Time         -- The time you have to pause before MouseTool clicks.
  38   Drag Time          -- (When Smart Drag is enabled) the time MouseTool waits, after it clicks
  39                         down, before it clicks back up if you don't move the mouse.
  40   Apply Times Button -- After changing either time, you must click this button.
  41
  42 * Start Button       -- Starts MouseTool.  (Well, duh.)
  43                         When it says "stop", clicking it will stop MouseTool.  (Duh, again.)
  44
  45 * command line       -- MouseTool has no command line options.
  46                         It does remembers its state when it is restarted, though.
  47
  48 * Hotkeys            -- None yet (as of version 1.1).  They are very useful, though, and may be added.
  49
  50
  51 Credit:
  52
  53 The idea for MouseTool came to me when I was thinking about head-tracking
  54 systems that allow you to move a cursor using your head orientation, and then
  55 send clicks when you pause.  As far as I know, I was the first person to use
  56 this technique with an ordinary mouse, but it is quite possible that I am wrong
  57 about that.  There are now other programs available for Windows and Macs that
  58 do this; I know that some were developed after MouseTool, but it is likely
  59 others came before.
  60
  61 If you know of another Linux- or Unix-based program that does this, please let
  62 me know (at jeff@mousetool.com)
  63
  64 The clever idea for Smart Drag was suggested by Joe Betts.  Thanks, Joe!
  65
  66 Other ideas in MouseTool for Windows that I hope to port to KDE were either
  67 suggested by MouseTool users or came out of email discussions with users.
  68
  69
  70
  71 Bugs and issues:
  72 Emacs   - Smart Drag and Emacs menus don't mix well; the menus don't stay visible
  73           long enough to use.  XEmacs seems to work fine.  Gvim also works well.
  74
  75 Taskbar - When you drag the taskbar using Smart Drag in KDE 2.x, kmousetool won't release
  76           the drag.  This can be scary if you're not expecting it, but simply clicking
  77           the mouse button manually fixes the problem.  KDE 3.x does not have this problem.
  78
  79           This seems to be an issue with the internals of KDE or QT code, and similar
  80           things happen in Windows.  I haven't looked into it much under KDE, but on
  81           Windows it happens when mousetool's timer stops while Windows waits for an
  82           upclick, and the upclick never happens because the timer is stopped;
  83           I'm sure the same thing is happening under KDE.