MouseMute v1.01 Copyright (c) 2002 George Mealer, All Rights Reserved
--------------------------------------------------------------------

1. Overview

MouseMute is a utility written to make it easier to bypass the
problems various mouse drivers cause with games and other applications
by allowing you to toggle mouse software on or off. It was
specifically written to work with Logitech MouseWare. However, it may
be useful with other mouse software packages, such as Microsoft
Intellipoint.

2. Disclaimer

This program is provided without any warranty and the user accepts
full responsibility for any damages, consequential or otherwise,
resulting from its use.

This archive is freely redistributable, provided it is made available
only in its complete, unmodified form with no additional files.

3. System Requirements

MouseMute should work on any version of Windows from Windows98 to
WindowsXP. It may work on Windows95, but is untested under that
operating system.

4. Installation

To install MouseMute, create a directory and unzip MouseMute.exe into
it. If you would like MouseMute to run when your system starts, add a
shortcut to it to your StartUp folder, found on the Start Menu.

5. Configuring MouseMute

The first time you run MouseMute, it will initialize its options to
work with a default WinXP Logitech Mouseware install. You may change these
options by right-clicking the MouseMute tray icon and choosing
"MouseMute Options..."

The options are explained below:

Double-Click Action:

Controls what happens when you double-click the tray icon. You can
choose to show the MouseMute options dialog, launch your mouse
software's options, or do nothing at all. Choosing the latter option
will speed up toggling via single-click.

Mouse Options Executable:

This is the program to launch to show your mouse software's options
dialog. By default, this is "MAIN.CPL", the Mouse control panel
applet. Most third-party software will hook this applet and launch
correctly. If not, you may need to select another executable file that
came with your mouse software. You may hit the button to the right of
this text box to browse executables on your system.

Mouse Software Executable:

This is the program that needs to be launched to enable the button-
and wheel-handling for your mouse software. By default, this is
"EM_EXEC.EXE" in the default Logitech Mouseware directory. You may hit
the button to the right of this text box to browse executables on your
system.

Mouse Software Window Class:

This is the class of the (usually hidden) window that the mouse
software keeps in the background. For Logitech Mouseware, this is
"Logitech E/M Executive". You may bring up a list of currently active
window classes on your system by hitting the button to the right of
this text box.

After setting the options, you may hit OK to commit the changes or
Cancel if you change your mind. You may also hit the Exit MouseMute
button to terminate MouseMute without saving your changes.

6. Using MouseMute

Once the options are set, the tray icon will reflect whether your
mouse software (as defined by the Window Class) is currently running.
A mouse indicates that it is running, whereas a mouse with a red
circle and slash indicates that it is not running.

Single-clicking the tray icon will toggle the status of your mouse
software. That is, if it is currently running, it will be terminated
when the icon is clicked. Conversely, if it is not running, it will be
launched when the icon is clicked.

Besides allowing you to disable/enable your mouse software and show
MouseMute options, the tray icon's right-click menu will also let you
launch your mouse software's options (if configured), show the About
MouseMute dialog, or exit MouseMute entirely.

6. Coming Soon

First, there will be a real installation/removal program, if only so
MouseMute won't leave registry pollution behind. Second, I would like
to eliminate the need to define the Window Class -and- the executable.
One is derivable from the other, with quite a bit of work (though the
way it is right now is actually a little more flexible). Finally, I'd
like to update the documentation (and possibly the install) with
proper parameters for toggling Intellipoint. If anyone happens to
figure out what the proper option setup for that is, I'd appreciate it
if they sent it along.

7. Bug Reporting

Please send any bugs, suggestions, comments, or issues, to me (George
Mealer) at geo@snarksoft.com.

8. History

1.0  - 8/4/2002   Initial Release
1.01 - 8/10/2002  Added Disable/Enable popup menu, better error reporting,
                  documentation updates.

9. Acknowledgments

Thanks go to Brad Bidnick and Eep for testing and feedback.

