
KeyMacroDef version 0.1b

What is it?

    KeyMacroDef is a program that extends predefined shortcut key 
    combinations on Windows to start your favorite programs easier and faster 
    without using the mouse. You can autostart this program by adding it to 
    "Start Menu/(All )Programs/Startup" menu. A small icon (K) on Systray 
    will appear showing KeyMacroDef is running. 
    By default Windows (XP and later) has a function that you can define 
    shortcut keys by right-clicking on a Desktop icon or Start Menu item and 
    set "Shortcut key" item in Properties dialog box. But using KeyMacroDef 
    this procedure can be replaced and your accelerator keys can be stored in 
    a centralized place. You can set very complex command strings for each key 
    combination.

System Requirements:

    - at least Windows 2000. Tested on Windows XP, Windows Server 2003.
    - .NET Framework (Windows Server 2003 contains it by default)
    - 130K of disk space for binary
    - a bit more disk space for the source code also
    - Visual Studio.NET to compile the source code

Licence agreement:

    Can be found in "Copying" file. This program is licenced under a BSD-like 
    licence (read it!).

Predefined shortcut keys are the following:

    Windows + e         : Windows Explorer
    Windows + r         : Run program
    Windows + u         : Utility Manager
    Windows + d         : Show Desktop (try it twice)
    Windows + f         : Find
    Windows + l         : Switch User/Log off
    Windows + b         : Remove focus from current Window
    Windows + m         : Minimize all windows
    Windows + Shift + m : Unminimize previously minimized windows
    Windows + Pause     : System Properties dialog
    Alt + Space         : System menu
    Alt + Shift         : Change Keyboard Layout (by default)
    F1                  : Help
    F2                  : Rename icon on Desktop (file in Explorer)
    F3                  : Find
    F5                  : Refresh Desptop/a Window(program specific)
    Ctrl+Shift+Escape   : Task manager

Installation:

    Copy the content of the "run" directory(KeyMacroDefDll.dll, 
    KeyMacroDefExe.exe, KeyMacroDef.conf) to somewhere 
    (eg. %ProgramFiles%\KeyMacroDef or if you do not have Administrator 
    privileges to any writeable directory). Create a link and drop it to 
    "Start Menu/(All )Programs/Startup". The .dll file should be placed in the
    same path as the executable or in the system path. The .conf file must be
    in the same directory as the executable.

Configuration:

    You can configure the program by editing the KeyMacroDef.conf file.
    After this you _must_ reload KeyMacroDef by right-click on the (K) icon
    and chosing Reload Configuration menu.

Configuration file format:

    The configuration file (KeyMacroDef.conf) is an XML file which consists
    of ProgramEntry nodes. Each Programentry node has a Description, a KeySet
    node which consists of some Key nodes and an Application. You can easily
    understand the file format so it does not need further explanation, look
    in the predefined configuration file. The maximum number of ProgramEntry 
    nodes is 32, the Key nodes is 4.

    Following key names can be used in KeySet node(without case sensitivity):
        A-Z, F1-F12, 0-9
        Ctrl, Right Ctrl, Shift, Right Shift
        Left Windows, Right Windows, Application

    Example for a ProgramEntry:

+++
	<ProgramEntry>
		<Description>Home directory</Description>
		<KeySet>
			<Key>left windows</Key>
			<Key>h</Key>
		</KeySet>
		<Application>%SystemRoot%\explorer.exe %USERPROFILE%</Application>
	</ProgramEntry>
+++

Wish you a very pleasent usage:

    Krisztian Pocza (kpocza@elte.hu)
	11/15/2003