CoolKeys v5.00 (Final)

© Copyright 2002-2003 Paul Bowlay. All rights reserved.
The official web site for CoolKeys is at www.paulbowlay.com

What is CoolKeys?

CoolKeys is a small program which gives you several handy hotkeys to the Windows Operating System. These hotkeys provide functionality that is currently missing from all versions of Windows and which the author deems essential. A full explanation of each is given below, along with the situations and keys via which they are invoked. Hopefully you will agree that CoolKeys makes Windows a more convenient and easy-to-use environment!

Legal.

By using CoolKeys you agree to all these terms: CoolKeys is © Copyright 2002-2003 Paul Bowlay and is free software (although it is not "freeware" or "public domain"). Although carefully tested with no evident faults found, you agree that you will backup all important system data and settings before running CoolKeys, and agree that by running it you will hold the author blameless in the event of any unforeseen loss and/or problem(s) incurred as a direct or indirect result of its use. CoolKeys is not spyware or adware, does not send or receive data over any type of network, does not add or remove anything from your Registry, does not create any unauthorised new files on your system, and does not make any unauthorised changes (or deletions) to existing files on your system. The term "unauthorised" refers to doing something to your files that you didn't specifically initiate yourself. The author does not guarantee that any Internet-related Special Commands of CoolKeys will always be available; however he will endeavour to supply alternatives whenever possible. Any distribution of CoolKeys is permitted as long as its zip file is not modified in any way. There is no technical support provided for CoolKeys at this time; however if you find a bug you should report it and it might be fixed in any future updates (no promises).

Why Free Now?

Some older versions of CoolKeys were trial versions that required payment. Sadly, nobody ever paid, and I've been told this is probably partly due to CoolKeys having so many freeware alternatives out there. Probably true, I guess. Hence, this version (v5.00) is now free but unsupported. However, if you're interested, and for a small fee, I am willing to build you a custom version of CoolKeys with your own graphic icons to replace all the built-in ones. Just make sure they are 32x32 pixels in size and then place your order securely online by clicking here -- I will reply by e-mail with further instructions. Thanks!

Requirements.

CoolKeys runs on Windows 95 or later. No other special requirements apply.

Using CoolKeys.

CoolKeys is started simply by double-clicking its icon (no "setup" installation is required). For CoolKeys to work with its folder-related hotkeys (described below), the "show full folder paths" feature of Windows must be enabled. If you are unsure of whether this is enabled, then please refer to the Troubleshooting section at the end of this manual.

Here is an explanation of all the hotkeys (shown in purple), along with how and when they can be used. Please note that the term "the focus" simply means that the item or window in question is currently selected and therefore has an "active" title bar.

Creating Custom Special Commands.

In addition to the special commands listed above, CoolKeys offers you the ability to create your own custom commands, and this is one area where CoolKeys really shines. Note that you'll need to be a "power user" to create custom commands, as they can be quite complicated if you don't understand the concepts. There are 5 types of custom commands that you can currently create (referred to as actions below):

Custom commands are stored in the MyCommands.ini file in the Data folder. If you open it and take a look you'll see some examples already in there. The format of custom commands is as follows: command = action what. The first example command in the MyCommands.ini file is calc = run calc.exe. This means that calc is the command, run is the action, and calc.exe is the what. Thus, if you press the Shift + Control + Z hotkey and enter calc, then the Windows Calculator will be run. Another example command is pb = visit http://www.paulbowlay.com, which means if you press the Shift + Control + Z hotkey and enter pb, then your web browser will open to the PaulBowlay.com web site. Understand? Good! :)

Now, what about the aforementioned Visit action (with or without dynamic data)? What this means is you can specify a command to open a specific URL with your own on-the-fly data. Look at MyCommands.ini again and you'll see: dic = visit http://www.dictionary.com/cgi-bin/dict.pl?term=###. Any Visit command that contains three hashes (###) will replace the hashes with your own data after the command part. So, if you pressed the Shift + Control + Z hotkey and entered dic word, then the web site of Dictionary.com would open at the entry for word (because http://www.dictionary.com/cgi-bin/dict.pl?term=### would actually open in your web browser as http://www.dictionary.com/cgi-bin/dict.pl?term=word). Understand? I hope so -- it's a bit hard to explain. :(

The last hard type of custom command to learn is the Type action, used to type pre-defined text into the window with the focus. Looking at MyCommands.ini you'll see type = type This was typed by CoolKeys.{ENTER}Isn't it groovy? ;){ENTER} in there. What this means is, if you open a Notepad window and then press the Shift + Control + Z hotkey and enter type, then the following text will be typed directly into Notepad:

This was typed by CoolKeys.
Isn't it groovy? ;)

As you can see, you can type a mixture of normal text and "untypable" keys such as {ENTER}. Here is the full list of available "untypable" keys for your reference:
{ALTDOWN} {ALTUP} {BACKSPACE} {CONTROLDOWN} {CONTROLUP} {DELAY}* {DELETE} {DOWN} {END} {ENTER} {ESCAPE} {F1} {F2} {F3} {F4} {F5} {F6} {F7} {F8} {F9} {F10} {F11} {F12} {HOME} {INSERT} {LEFT} {PAGEDOWN} {PAGEUP} {PRINTSCREEN} {RETURN} {RIGHT} {SHIFTDOWN} {SHIFTUP} {TAB} {UP}
* Specify {DELAY} to pause the typing for one second.

That's it for the custom special commands tutorial. Please note that no support can be given for these commands. Good luck!

Troubleshooting.

If the hotkeys or features of CoolKeys don't seem to be working for you, please check all the following:

CoolKeys has a few minor problems that do not affect its usability in any major way. These are:

Known Problems.

CoolKeys currently has the following unfortunate problem:

Optional Tweaks.

There is a file called Settings.ini in the Data folder which contains several tweakable settings that affect the way CoolKeys works. Take a look if interested, but note that if you make any such tweaks you will need to exit and restart CoolKeys for them to come into effect, since CoolKeys only reads the file on startup. You should leave the file alone if you are perfectly happy with the way in which CoolKeys works.

Uninstalling.

If you want to remove CoolKeys from your system, simply end it and then delete its folder. That's it!

The Future.

CoolKeys currently does all that I desire and is therefore considered "complete".

Acknowledgment.

Many thanks must go to John Klofac for his valuable bug-testing and useful ideas. John was also the designer of the CoolKeys icon so please visit his web site at www.dmpro.com.au for your own image design needs, as well as professional audio/video production at competitive rates. Tell him "Otser" sent you! ;)