Numpad Mouse

version 0.6c

by

Kalvin Au



Description

Numpad Mouse lets you control your mouse using the keys on the Numpad.

It also features position marker that allows you to mark the mouse positions for shift and precise moving.

Numpad Mouse transforms your numeric keypad into a versatile mouse.


Features:
  1. Mouse wrap
  2. 21 mouse anchors
  3. Move mouse automatically accomplished with optional left, right, middle, double, and control clicks
  4. 8 directions mouse movement
  5. User defined speed
  6. Mouse clicks and drag, including control clicks
  7. Optional sound effects
  8. Programs launcher
  9. Handy 10-page 'Note by the Mouse' with alarms function
  10. Display mouse coordinates
  11. Display RGB hex code under mouse cursor
  12. Support English, Dutch, and French

Files List:
  1. FILE_ID.DIZ
  2. Numpad Mouse.exe
  3. Numpad_Mouse_readme.html
  4. NM_res.dll

How To Use?

First, put all the files in the files list above in a same folder.
Double click "Numpad Mouse.exe", then, make sure the NumLock key is on.

It's now ready to control your mouse via the Numpad keys.

Mouse Movements:

'4'   move left
'6'   move right
'8'   move up
'2'   move down

like this:
 
  8       ↑
4   6   ←  →
  2       ↓

To move the mouse diagonally, you need the 'Win' key on your keyboard:  Press and hold the 'Win' key, then 1, 3, 7, and 9 are to move the mouse diagonally.


Mouse clicks

'1'  left click (press twice to simulate a double-click)
'3'  right click
'0'  hold left click (may use to drag window)

'0'  is a toggle key - press again to release the left click.

For  'control clicks', you need to activate the 'control clicks' function first in the 'Settings' window.  Once activated, pressing 'Ctrl' + '1' will perform a control left click, and 'Ctrl' + '3' a control right click.

Note:  If you have marked the mouse positions with Alt + 1 and Alt + 3, Ctrl + 1 and Ctrl + 3 will not move to the marked positions, instead they will perform a control left or right click until this option is toggled off.  However, Ctrl + Alt + 1 and Ctrl + Alt + 3 are unaffected.



Display Mouse Coordinates and RGB hex code

'7'   display mouse coordinates
'9'   display RGB hex code under mouse cursor.


Mark Mouse Positions

'+'   mark current mouse position, only in memory,
'5'   move mouse to the position marked with '+'

To unmark the mouse position marked by '+', press it twice.
Without the presence of a marker, pressing '5' will then move the mouse to the center of the current active window.

If you press the '5' again, each press of it will bring up one of the underlying windows and the mouse cursor will move to the center of that windows.  If you continue to press this key, it'll eventually cycle through all windows on your Desktop, one by one.


Another 10 mouse positions will be stored in a file named "numpad_mouse.ini" which will be created in the same folder automatically when you first mark a mouse position.

To mark mouse positions, press:

'Alt' and any one number keys (0 to 9),

To move the mouse to the marked position, press:

'Ctrl' and any one number keys (0 to 9).

To move the mouse to the marked position and left click, press:

'Alt' + 'Ctrl' and any one number keys (0 to 9).

If you want to move the mouse to the marked position and do a series of several tasks, read the 'Advanced Usage' section below.


Second Set of Mouse-Markers

There is an extra set (set 2) of mouse-markers you may shift to use simply by pressing 'Ctrl' + '.'  (the 'point' or 'Del' on the numeric pad).
The usage of this extra set is exactly the same as the default set (set 1).  You may toggle the use between these two sets of mouse-markers by pressing 'Ctrl' + '.'.

The marked mouse positions for both the default set and the extra set will be stored in the file: "numpad_mouse.ini" under the sections:

[Numpad Mouse Anchors]


and

[Numpad Mouse Anchors Set 2]


respectively.



Accessing Numpad Mouse Settings window

Press 'Ctrl' + "*" (Numpad Asterisk).

In this settings window, you may

  1. fine tune the moving speed of your mouse,
  2. define programs to launch,
  3. toggle mouse wrap mode,
  4. create a shortcut on your desktop,
  5. toggle sound effect,
  6. toggle the display of the system icon,
  7. toggle control clicks,
  8. toggle 'SmartMouse' feature,
  9. toggle sleep mode, and
  10. change language to English, Dutch, or French.

Numpad Mouse Settings Menu

Here is a brief description of some of the options in the Options menus:

Default: reset the 'step', 'speed', and 'wrap mode' settings to default.
shortcut: create a Numpad Mouse shortcut on your Desktop.
About: read who has made this program.
Exit: quit the application.



Toggle Sound Events:

There are six sound events you may toggle individually.
They are:
  1. Mouse click
  2. Mouse button released
  3. Mouse button hold
  4. Info
  5. Mouse anchoring
  6. Asleep / awake
and they mean:


'SmartMouse' feature:

SmartMouse is a feature to help you control your mouse much at ease.
You may toggle this feature from the Options menu.

With the SmartMouse feature on, you need to press any of the eight directional mouse mover keys:   2, 4, 6, 8, Win + 1, Win + 3, Win + 7, or Win + 9, only once, the mouse will continue to move until you press the Spacebar.

If you've "wrap mode" off, the mouse cursor will stop at the edges of the screen, otherwise, it'll continue to move until the Spacebar pressed.

Alternatively you may press the "Home" key to stop SmartMouse.  In this case, SmartMouse will move back to the position where you've started SmartMouse.

If the 'bounce' feature is checked, the mouse cursor will bounce at the edges of the screen when "wrap mode" is off.

During SmartMouse moving, you may change the directions by hitting any of the eight directional keys.

All other functions, such as marking mouse position, move mouse to marked position, clicks, get info, etc, are still available.

Speed for SmartMouse:

The 'speed' for SmartMouse can be adjusted while your mouse cursor is moving, press the 'up' arrow key to increase, the 'down' to decrease.

The 'step' can also be adjusted while moving, press the 'right' arrow key to widen the step, the 'left' to narrow.

Note: This 'speed' is for SmartMouse only, it will not affect the speed for Numpad Mouse.  However, if you change the 'step', it will change the 'step' for Numpad Mouse too, for they share the same 'step' value.

When the 'speed' or the 'step' has reached the top or the bottom, a sound will cue you.



How to Change Language?

To change the language, just click the Languages menu and click the language you like.

Note:  Languages other than English require an additional plug-in file in the same folder (or in your system folder).  You may find the link on the Numpad Mouse download page to download.

Or click here to go to the webpage directly.


The Launcher

The launcher allows you to define a total of four external programs to launch when the mouse is positioned, within the range, on either of the four edges of the screen.

You may drag and drop the program you want to launch on to the input field, or use the 'Browse' button to search.

You may also adjust the 'activated range' (in pixel) to activate the launcher.

Since the four edges on the screen have overlapping corners, they have a priority order, which is: Top, Bottom, Left, and Right.

For example, when the mouse is positioned on the upper right corner, the program defined for the 'Top' will be launched rather than for the 'Right', for the 'Top' has the priority.

The shortcut Numpad Asterisk '*' is used to launch the defined programs.

Note: The programs will not be launched automatically.  Two conditions must be met:

1. The mouse is on either of the four edges and within the activated range, and
2. the shortcut Numpad Asterisk '*' is pressed.


When all is set and done for the settings, remember to click 'OK'.


Suspend Numpad Mouse

There are two ways to suspend Numpad Mouse:

1. sleep mode
2. Pause mode

Press Ctrl + '/' (Numpad slash) to activate 'sleep mode'.
It is a toggle, so press Ctrl + '/' again to re-enable Numpad Mouse.
In 'sleep mode', all Numpad Mouse features are suspended; however, the 'settings' window is still accessible by pressing Ctrl + '*'.

Click the Numpad Mouse tray icon then click 'Pause' to activate 'Pause mode'.
It is also a toggle, so click again to re-enable Numpad Mouse.
In 'Pause mode', Numpad Mouse is completely 'paused'.


Exit Numpad Mouse

There are three ways to quit Numpad Mouse:

  1. click the Numpad Mouse tray icon then click 'Exit'
  2. Click 'Exit' from the Options menu in the Settings window.
  3. Press Ctrl + '-' (Numpad Minus).
Note: The third way: Ctrl + '-', is a safe-exit, and is recommended.

If you have changed your Settings, changed the speed for SmartMouse, or updated your note and/or set your alarms with Note by the Mouse, it's better to exit the application using the third way for Numpad Mouse will not save all those changes and updates if you exit using the other two.





That's it for the basic usage.

If you want to use all the additional features, continue to read.

Otherwise, you're ready.










Additional Features





About 'Note by the Mouse'

'Note by the Mouse' is designed for writing short notes and reminders.  It's so named because whenever you press the shortcut key, the 'Note by the Mouse' window will always move to near your mouse.

Each page of note has a capacity of 8 KB;
There are a total of 10 pages.

A 24-hour alarm enables users to set alarm for each of the 10 pages.  A window will pop up showing the first 300 bytes of the content of the 'Note' with optional audible alert when the alarm time reaches.

The shortcut to call  'Note by the Mouse'  is Numpad slash (/).

To close it, press ESC.

The content of the notes will be saved automatically to a subfolder named "mouse.notecase" upon close.


'Note by the Mouse' Options menu

Two functions in the Options menu will be explained here:

'erase':   this is to clear the content of the current page.
'restore':   this is to restore the current note to what 'Note by the Mouse' has in memory.


How to change the Note Pages?

Highlight the 'current page' box on the lower right corner, press the 'up' or 'down' arrow key to choose the page you want to go, then click the 'Go' button, or press Alt + 'G'.

You may also click on the 'up and down' button next to the 'current page' box to flip through all pages one by one.


Setting Alarms

To set an alarm on:

Use up and down arrow-keys or mouse click to adjust the 'hours' and 'minutes' then press the 'Alarm' button.  The 'colon' between the 'hours' and the 'minutes' fields will change to red color, which signifies that the alarm is set on.

You may get the current time into the 'hours' and the 'minutes' fields by right clicking the window of the 'Note by the Mouse', then click 'current time'.  (Note:  not the editing field.)

To set an alarm off:

Press the 'Alarm' button, again.  The 'colon' between the 'hours' and 'minutes' fields will change to normal black color (or your system color for text), which signifies that the alarm is set off.

To change the alarm time:

First, press the 'Alarm' button to set the alarm off, then adjust the 'hours' and the 'minutes', and press the 'Alarm' button again.


About the icons

The icon will be changed according to the alarm status for that current note.
There are three icons:

Notes on Usage:

1.   If you modify the alarm time after the alarm is set, the alarm time will be updated automatically whenever you:
2.   You may always check whether the alarm time is correct by hovering your mouse cursor over the 'colon' (between the 'hours' and the 'minutes' fields).  If there is alarm(s), it will show you the most recent alarm time and the note-page the alarm is set for in a 'bubble message'.

3.   Once the alarm is triggered, it will be set off.  Which means the alarm will not cycle for another day.

4.   However, if the alarm is not yet triggered, and you closed the program, it will still be available next time you run the program.

5.   If you set the alarm with the current time, there are two possibilities:
  1. it will be taken as 24 hours later if there is/are another waiting alarm(s);
  2. it will be taken as now if it is the only alarm.  (There will usually be 20 seconds delay for the alarm to kick off.)
6.   When you have finished with 'Note by the Mouse', you may close the window by pressing ESC.  Numpad Mouse will monitor the time and alert you when the set alarm time reaches.



Advanced Usage

This section will explain how to edit the "numpad_mouse.ini" file to make Numpad Mouse to do a series of several tasks with just one single keypress.

Normally, when you press Alt + Ctrl + number keys, the mouse cursor will be moved to the marked position than left click.  You may change this action according to your personal needs.

The syntax of the "numpad_mouse.ini" file is:

                [Numpad Mouse Anchors]
                Ctrl-?=x,y,Macro(s)

where:

        ?  is the Number shortcut (0 to 9);
        x  x-coordinate;
        y  y-coordinate;
        Macro(s)  are mouse actions macros you want to
                  perform and keystrokes you want to
                  input to the focused window.
There are a total of 34 macros you may use in the 'Macro(s)' field.  They are all preceded by a "^".  They are:
        "^0" to "^9",
        "^PAUSE1" to "^PAUSE9,
        "^LCLICK", "^RCLICK", "^MCLICK", "^DCLICK", "^CCLICK",
        "^HLBTN", "^RLBTN", "^HRBTN", "^RRBTN", "^HMBTN", "^RMBTN",
        "^SPACE", "^ENTER",
        "^(x,y)", and
        "^[BUTTON NAME]".

And they mean:

"^0" to "^9"    allow you to call other shortcut(s);

"^PAUSEn"    pause the mouse action for n second(s);

"^LCLICK"    perform left click;
"^RCLICK"    perform right click;
"^MCLICK"    perform middle click;
"^DCLICK"    perform double click;
"^CCLICK"    perform control left click;

"^HLBTN"    hold the left mouse button;
"^RLBTN"    release the left mouse button;
"^HRBTN"    hold the right mouse button;
"^RRBTN"    release the right mouse button;
"^HMBTN"    hold the middle mouse button;
"^RMBTN"    release the middle mouse button;

"^SPACE"    input a space;
"^ENTER"    insert an 'Enter';

"^(x,y)"    The (x,y) coordinates you want the mouse to move to;

"^[BUTTON NAME]"    allow you to define the name of the button to click.


About 'BUTTON NAME'

'BUTTON NAME' must be within square brackets.  For example:
        ^[Ok]
        ^[Cancel]
        ^[Yes]
        ^[No]
You may use partial name, e.g.   ^[Canc], this will still click the 'Cancel' button.

Note: You do not need to specify the coordinates for the button to click.  Numpad Mouse will search the position of all buttons on the active window and click the one you specified for you.  If the button name is not found, it will skip to next actions.  If you are running under a system other than English, you may also use this feature.  For example:
        ^[Ja]
        ^[Nee]
        ^[Annuler]
        ^[Si]

Examples:

Example 1:

                [Numpad Mouse Anchors]
                Ctrl-1=611,137, ^(611,137) ^2^3^2^3^2^3 ^[OK]
                Ctrl-2=200,400
                Ctrl-3=400,400

In the above example, if you press Ctrl - 1, the mouse will simply move to the coordinates 611,137.  But if you press Ctrl - Alt - 1, the mouse will first move to the coordinates 611,137, then move from left to right and right to left three times, by calling the shortcuts '2' and '3' three times, as if you had pressed Ctrl - 2 and Ctrl - 3 three times, and finally go back to click the 'OK' button.

Example 2:

                [Numpad Mouse Anchors]
                Ctrl-1=191,501, ^(191,501) ^RCLICK q          ^2
                Ctrl-2=300,750, ^(300,750) ^DCLICK ^PAUSE1    ^3
                Ctrl-3=550,100, ^(550,100) ^LCLICK login name ^4
                Ctrl-4=550,150, ^(550,150) ^LCLICK password   ^5
                Ctrl-5=700,150, ^(700,150) ^[OK]
                ...

In the above example, when Ctrl - Alt -1 is pressed:

The mouse will move to (191,501), perform right click, type 'q', then call shortcut Ctrl - 2, which in turn moves the mouse again to (300,750) and double click, pause for one second, then call shortcut Ctrl - 3, which moves the mouse to (550,100), left click, type in "login name", call shortcut Ctrl - 4, which moves the mouse to (550,150), left click, type in "password", call shortcut Ctrl - 5, which moves the mouse to (700,150), and finish the mouse actions by clicking the 'OK' button.

Above example may have opened a document with Quick View, then opened a browser, typed in login name, password and clicked the 'OK' button for you.

You only need to press Ctrl - Alt - 1 to do all the above tasks!

Example 3:

		Ctrl-3=400,500, ^(400,500) ^HLBTN ^4
		Ctrl-4=10,50,   ^(10,50) ^RLBTN ^PAUSE1 ^[Yes]

In the above example, supposing the marked mouse position for Ctrl - 3 is a file to be deleted; for Ctrl - 4 is the Recycle bin, by pressing Ctrl - Alt - 3, Numpad Mouse will drag the file to the Recycle bin, pause for one second then click "Yes".



Further Notes and Examples on using the Macros

1.  Normally, if you've marked a mouse position with Alt + any numeric number keys, pressing Ctrl + Alt + number key will move the mouse to the marked position then left click, however, if you've edited the numpad_mouse.ini file by appending macro(s) or text to the line, the move to the marked position and the left click will no more be the default actions.  In this case, you need to explicitly instruct Numpad Mouse to do them by adding the macros "^(x,y)" and "^LCLICK".

So, below two lines are identical - they will both move the mouse to (200,600) then left click when you press Ctrl + Alt + 2.

		Ctrl-2=200,600
		Ctrl-2=200,600, ^(200,600) ^LCLICK

2.  Whenever there are macros appended to the shortcut line in the numpad_mouse.ini, all spaces will be ignored.

For example, if you want Numpad Mouse to type "Jack and Jill" on the focused box or window for you whenever you press Ctrl + Alt + 6, put the line as below:

		Ctrl-6=200,600, Jack and Jill
However, if you need an 'Enter' input followed the typing of "Jack and Jill", you need to put the line like this:
		Ctrl-6=200,600, Jack ^SPACE and ^SPACE Jill ^ENTER

3.  The shortcuts using Ctrl + number keys are unaffected by the macros.  So, practically you may set two different mouse actions in one line.  E.g.

		Ctrl-6=100,100, ^(200,200) ^DCLICK

In the above example, if you press Ctrl + 6, the mouse will simply move to (100,100), but if you press Ctrl + Alt + 6, the mouse will move to (200,200), then double click.

Even further, you may press Alt + 6 if need to mark a new mouse position, the appended macros you've put there will not be removed.

4.  The macros can make up the functions for what Numpad Mouse is missing.

Currently, Numpad Mouse has only the function to hold the left button ( Numkey 0 ), if you need to hold the right button, make a line as below in your numpad_mouse.ini:

		Ctrl-3=100,100, ^HRBTN
		Ctrl-6=100,100, ^RRBTN

Now, pressing Ctrl + Alt + 3 will hold the right mouse button;
Ctrl + Alt + 6 will release it.

If you often need a double click, below will double click whenever you press Ctrl + Alt + 1.

		Ctrl-1=100,100, ^DCLICK

Likewise, below will middle click whenever you press Ctrl + Alt + 2.

		Ctrl-2=100,100, ^MCLICK

5.  Two or three buttons cannot simultaneously be hold.

In the example below, Numpad Mouse will hold the left mouse button, release it, than hold the right mouse button, release it, than hold the middle mouse button.
		Ctrl-1=100,100, ^HLBTN ^HRBTN ^HMBTN

6.  You may use the numpad_mouse.ini to store the text you frequently need to paste to other applications.  E.g.

		Ctrl-1=1000,900,www.geocities.com/kalvinau2003/k2003.html
		Ctrl-2=1000,900,kalvinau2003@yahoo.com
		Ctrl-3=1000,900,Numpad Mouse version 0.6c

Above lines will paste my web address, my e-mail, the name and the version number of this application to whatever applications on focus whenever you press Ctrl + Alt + 1, Ctrl + Alt + 2, Ctrl + Alt + 3 respectively.




Disclaimer
  1. No mice and other animals have been harmed in the making of this software.

  2. The author shall not be liable in any way to any person for any loss or damage (whether direct or otherwise) arising from or in connection with the use of this software, including but not limited to his/her real mouse getting dusty due to out of use for a long mouse time.

  3. The author reserves the right to release newer version with amendments and/or modifications to all the functions of the software at any time at his sole discretion without prior notice.

  4. This disclaimer is written in English, Dutch, and a language of Mice.  In case of inconsistencies, the language of Mice version shall prevail.







Software Licence
  1. The author hereby grants to you a non-exclusive and non-transferable licence to install, store, run and use the software on your computer in accordance with the terms and conditions of this Agreement but not further or otherwise.

  2. Except to the extent permitted by the author, you shall not, nor allow others to copy, sub-license, distribute, rent, loan, lease, sell, transfer, exploit, alter, modify, adapt or translate the software nor decompile, disassemble or reverse engineer the same nor attempt to do such thing.

  3. Upon installation of this software, you agree that you shall not, directly or indirectly such as using mouse-traps or poisonous baits, nor allow your cat(s) to kill, murder, harm, hurt, crush, drown, kick, abuse any mice or mouse-like rodents including rats, mice, hamsters, jerboas, lemmings, and voles.

  4. This Agreement is subject to the laws of the Kingdom of the Rodents and the parties submit to the non-exclusive jurisdiction of the courts of the Kingdom of the Rodents.

  5. This Agreement is available in English, Dutch, and the language for Rodents versions.





History

version 0.6c  (February 23, 2006)
version 0.5  (August 31, 2005)
version 0.4  (March 23, 2005)
version 0.3  (February 21, 2005)
version 0.2  (September 23, 2004)
version 0.1  (July 31, 2004)


System Requirements

Any Windows operating systems version 95 or above.


How much does it cost?

Numpad Mouse will cost you one email.
If you use it or store it at your disposal, I would like to have an email telling me about that.   My email is   kalvinau2003@yahoo.com


Suggestions and Comments

Should you have any suggestions and comments, please send email to the above address.

Or you may write in my guest book .






A Note to Thank

Special thanks to Peter Zwitser who has helped make the Dutch translation!



Kalvin Au
February 23, 2006
Homepage: http://www.geocities.com/kalvinau2003/k2003.html