Mouse Tamer 2.0
With Keyboard Control
Features

Mouse Tamer is a utility that allows you to make your mouse move around your screen and perform actions that you specify. With Mouse Tamer's keyboard control, you can also make Mouse Tamer type anything you want into any application. Mouse Tamer's keyboard automation can change the way you enter data. You can control your mouse through Mouse Tamer in 2 different ways. First, you may simply record what you do with your mouse and then play it back. The other way to get precise control over your mouse is to write Mouse Tamer scripts and play them back. Once you've made a recording or written a script, you may save your work in a Mouse Tamer script file ".mtm". While you're building a script, all the actions of your script will be displayed in the main area of the Build tab. There, you can edit, add, and delete the actions in your script. To rearrange the actions in your script, simply drag and drop them in the order you prefer. To edit an action in the queue, double click the entry to display that action's properties. Once you're ready to run your script, press the Play button. If your script is long or loops a number of times, you can make the script stop playing by pressing the "q" key.


There are 17 different actions to work with in Mouse Tamer:

RECORDING is the easiest action to use. All you need to do is press the Record button, move your mouse around and click on areas of your screen, then press the "q" key to stop recording. A RECORDING action will appear in your list of actions. The RECORDING action detects either left or right mouse button clicks, locations on your screen, double clicks, selection boxes, and dragging. Use the Mouse Tamer sounds to know when each of your recorded actions has registered in the recording.
SENDKEYS will send any keyboard keystrokes you choose to whichever window is active. Just fill in the keystrokes you would like to send in the given area. Select the "Control" or "Alt" options to specify a keystroke combination using those special keys. For example, to send a "Ctrl-x", you would select "Control" by clicking the box next the word "Control" and type "x" in the field. To resume normal typing, simply click the box again to turn "Control" off. To delete a keystroke, press the "Delete Keystrokes" button. You may also highlight a portion of text before you click the "Delete Keystrokes" button. Doing so will delete anything you have highlighted. The text you type in the SENDKEYS window may look differently than what will actually be typed when you run your Mouse Tamer script. For example "Hello World" will look like "(Shift+h)ello (Shift+w)orld". This is because a capital "w" is created by holding down the "Shift" key and the "w" key at the same time. By displaying this format in the SENDKEYS window, it will be clear as to what keys Mouse Tamer is going to type when you run your script. Many programs utilize keyboard shortcuts to perform certain tasks. With this format, Mouse Tamer will be able to easily display all the keys involved in a keyboard shortcut you may wish to use. For example, (Shift+Alt+Ctrl+s) would be like holding down the "Shift", "Alt", "Ctrl", and "s" key all at the same time. Use multiple SENDKEYS actions with other Mouse Tamer actions to navigate your mouse to fields of forms, documents, or anything else, and fill them out.
LEFT CLICK DOWN is a down click of the left mouse button. A full left mouse click would consist of a LEFT CLICK DOWN followed by a LEFT CLICK UP. Enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action.

LEFT CLICK UP is an up click of the left mouse button. A full left mouse click would consist of a LEFT CLICK DOWN followed by a LEFT CLICK UP. Enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action.

RIGHT CLICK DOWN is a down click of the right mouse button. A full right click would consist of a RIGHT CLICK DOWN followed by a RIGHT CLICK UP. Enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action.
RIGHT CLICK UP is an up click of the right mouse button. A full right click would consist of a RIGHT CLICK DOWN followed by a RIGHT CLICK UP. Enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action.
FULL CLICK may be either specific to the left or right mouse button. It is the action of a mouse button being clicked down and then released up. Specify either left or right click using the left and right buttons, then enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action.
CLICK DRAG is the action of clicking down, then moving the location of the mouse, then releasing the button. It can be specific to the left or right mouse button. Specify either left or right click using the left and right buttons, then enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action. Repeat this procedure to set the location of the final point of the CLICK DRAG action. This is good for either making a selection box or dragging windows around the screen.
LOC sets the specific location of the mouse. For example (0, 0) would be the upper left hand corner of your screen. Enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action.
PAUSE pauses movement of the mouse. Enter the length of pause in seconds. This is good for setting the mouse in a location for a set period of time.
LINEAR MOVE moves the mouse from one specific location to another. Enter coordinates manually or move your mouse to the desired location and press enter to set the location of this action. Repeat this procedure to set the location of the final point of the LINEAR MOVE action. For example, a LINEAR MOVE from (0, 0) to (500, 0) would make your mouse move in a straight line across the top of your screen.
COPYTEXT copies specified text onto the system clipboard. Specify the text to copy in the space provided. For example, if you use COPYTEXT with the text "hi there", the next time you perform a paste with your mouse, it will paste "hi there" into whatever your mouse is clicked on. Normally this action is followed by a recording that selects paste from the right click contextual menu in the desired location.
CHAOS activates random movement of the mouse for a specific period of time. Enter the length of chaos in seconds. If you want to have continuous random movement of your mouse, choose to loop your script infinitely in the options tab. Your mouse will move randomly until you press the "q" key.
URL LAUNCH opens your default web browser with a specific URL at a specific location on your screen with specific dimensions. Specify the target URL in the space provided. You may also specify values for the window width, window height, and corner of the browser window by entering the numbers into the fields provided.
INSERT SCRIPT embeds a saved script into another script. The inserted script will behave like a single action although it may consist of many actions internally. Specify the path to the ".mtm" file, or browse using the button.
FILE LAUNCH opens a file with its associated application. If you perform FILE LAUNCH with a ".txt" file for example, the program that handles ".txt" files on your system will open with the file you specify. Specify the path to the file, or browse using the button..
MTCLOSE will shut Mouse Tamer down. This is useful if you want to write a script that closes itself at a certain point. Make sure that you have saved your script, otherwise the save dialog will prevent Mouse Tamer from closing completely.
TRASH is for deleting actions. Select an action then click this button to delete the selected action.
Mouse Tamer Sections

Build Tab This section of Mouse Tamer is where you can create, edit, play, record, and save your own Mouse Tamer scripts. Check out the Actions section for details on what mouse actions you can do from the Build Tab. There are also the following options:


Record See description above.
Play Begin playing your script.
New Script Create a new script.
Open Script Open a saved script.
Save Save a script to a file.
Copy Copy an action from the queue.
Paste Paste a copied action into the queue.
Demos Tab We've provided some useful demo scripts for you to use in the demos section. It's a great way to get started with Mouse Tamer. Each demo displays different capabilities of Mouse Tamer. Simply highlight the demo you would like to preview and click the Play button.

Options Tab This is where all of the script playback options and Mouse Tamer preferences can be adjusted. Playback speed of scripts, sound preferences, and looping capabilities are a few options you can customize here. Enter a number from 0 to 10 for playback speed, 10 being he fastest. Enable looping causes Mouse Tamer to loop back to the beginning of a script after the end of the script is reached. Specify the number of loops for your script in he space provided, or check infinite looping for your script to loop until you press "q". You can also enable sound playback to help with recording.

Help Tab This is where you can access the different formats of help including PDF, TXT, and HTML. Email address and links can also be found on the Help tab.

Using Mouse Tamer With the Command Line

Mouse Tamer supports the use of the command line in Windows. Using the command line, you can launch Mouse Tamer with a specified script, which it will run upon loading. You can also set the -autoclose flag which makes Mouse Tamer close down after it has run your script. If you use -autoclose with looping disabled, Mouse Tamer will exit after the script is run. If you use -autoclose with looping enabled for a set number of loops, Mouse Tamer will exit after it is finished looping. If you use -autoclose with infinite looping enabled, Mouse Tamer will exit after one iteration of your script.

Examples:
This will launch Mouse Tamer, open myscript.mtm, run it, and then exit:
"C:\Program Files\Programmingart\Mousetamer\mousetamer.exe" -autoclose "C:\Windows\desktop\myscript.mtm"


This will launch Mouse Tamer, open myscript.mtm, run it, and then remain open until you close it:
"C:\Program Files\Programmingart\Mousetamer\mousetamer.exe" "C:\Windows\desktop\myscript.mtm"


If the path to Mouse Tamer, or the path to your script doesn't contain spaces, you don't need to use the quotation marks:
C:\Mousetamer\mousetamer.exe -autoclose C:\mystuff\myscript.mtm

Scheduling Mouse Tamer with Windows® Task Scheduler

Mouse Tamer can easily be scheduled to run scripts at any time using the Windows® Task Scheduler. First, find the Windows® Task Scheduler. It should be in your Start Menu under "System Tools" [it's called "Scheduled Tasks" there], and most PC's come with it already in the System Tray as well. Find it and open it. Now double click on "Add Scheduled Task". A wizard will pop up to help you out, so click Next on that first window. Now click on Browse and navigate to your mousetamer.exe file [it's default location is C:\program files\programmingart\mousetamer\mousetamer.exe] and click the radio button next to "One Time Only". Hit Next again and for the time and day just select 7 or 8 minutes from your current time so you can see the results right away. Hit next again and it will inform you that you have successfully scheduled the task, but don't forget this IMPORTANT step: make sure you have "Open Advanced properties for this task when I click finish" selected!

Now the properties window will pop and in the Run field you should see something like "C:\Program Files\programmingart\Mousetamer\mousetamer.exe" Just make sure it's the path to your Mouse Tamer executable. Now to have Mouse Tamer run our script when it starts up we need to add another line of text at the end. Basically just the path to the script file itself. So for example if you put the script on your desktop like I suggested then your complete Run field should read :
"C:\Program Files\programmingart\Mousetamer\mousetamer.exe" "C:\Windows\Desktop\tutorial.mtm" Please make sure that the two arguments are separated by a space and both are surrounded by quotes. Finally hit OK to accept your changes. Now your task should execute as scheduled. And keep in mind that the Close Mouse Tamer action was designed to turn Mouse Tamer off after a scheduled run if you need that functionality.

Mouse Tamer Registration

Mouse Tamer can be easily and quickly registered online, by phone or mail. Please go to http://www.programmingart.com/products/mousetamer for registration information. Once registered, Mouse Tamer will operate for an infinite amount of time, and your registration is good for any future updates to this version of Mouse Tamer. To receive the latest news and announcements from Programming Art, please sign up with our mailing list at http://www.programmingart.com/register. We will keep you informed with updates to Mouse Tamer and great new products from Programming Art.

Tech Support

Tech Support is available via email at support@programmingart.com.
Visit us at http://www.programmingart.com/products/mousetamer for up-to-date information on Mouse Tamer, and registration instructions.
You will also find useful Mouse Tamer tutorials at http://www.programmingart.com/free/tutorials.

Thank you for using Mouse Tamer!