// ----- BBKeyhook v0.1b ----- \\

Author  : Kaloth
Website : http://www.geocities.com/madant8
email   : mulletwarriorextreem@hotmail.com

Licence : GNU General Public License (GPL version 2 or later)

// ----- What is it? ----- \\

I made this plugin to fix my multi-media keyboard under BB4win.
Basically it's a low level keyhook that can map any VK (Virtual Key)
code to a command line action or to the default mixer 'mute', 'volume up'
and 'volume down' actions.

NOTE: This is a beta release, it works on my comp but is far from
being certified stable, use at you own risk!


// ----- How do I train it to my keyboard? ----- \\

All keyboard keys are represented by a VK code. Some manufacturers use different VK codes for special keys, like 'mute' than others. In order to cater for this BBKeyhook as a config mode that you can put it in to by changing the rc setting to 'True'. Once in this state it reports the VK code of any key you press by displaying it in the BB4win toolbar.

// ----- Bro@ms ----- \\

None as yet, maybe in the future :)

// ----- RC Settings ----- \\

An example rc file is included and should be fairly self explanitory.

But just in case here is a list of the settings and what they do...

BBkeyhook.plugin.ConfigMode?:

    If set to true then the VK code number for any keys pressed is reported to the BB Toolbar. 

BBkeyhook.plugin.mute:

    Assigns a VK code number to the mute mixer action.

BBkeyhook.plugin.volume_up:

    Assigns a VK code number to the volume up mixer action.

BBkeyhook.plugin.volume_down:

    Assigns a VK code number to the volume down mixer action.


Commandline actions...

BBkeyhook.plugin.key<n>:

    Assigns a VK code number to action n.

BBkeyhook.plugin.command<n>:

    Assigns a command eg: explorer.exe

BBkeyhook.plugin.argument<n>:

    Assigns command line arguments eg: d:/my files/

Note: <n> is a number from 0 to 24


// ----- Change History ----- \\

-- v0.1b

    Initial Code Version.