README for keyfunc
by Jonathon Fowler
jonof@edgenetwork.org
http://jonof.edgenetwork.org/?p=misc#keyfunc

17 September 2004


Keyfunc is a program I wrote to provide the ability to run programs from the
press of a multimedia key on a keyboard that posesses such keys. Uncontent to
use the software the manufacturers of my keyboards provided, I wrote my own
program to do the job, and this is it.

I have tested the program with these keyboards:

	* Diamond Touch (Mitsubishi) or Belkin, model 6511-UP
	  (requires the hook option be enabled)
	* Logitech, model Y-SG3


LICENSE AND WARRANTY

This program is licensed under the terms of the GNU General Public License
Version 2. See the included GPL.TXT file for the full text of the license.

The program carries no warranty of any kind. You use this completely at your
own risk. I deny all responsibility for this program.


USAGE AND CONFIGURATION

The program is configured using a file named "keyfunc.ini" which is to be
found in the same directory as the executable. Here is the help information
you would get if you run the program with the "/h" switch:

---8< (snip) 8<---
KeyFunc by Jonathon Fowler
Program to capture the extra function keys on modern 104-key keyboards.

Parameters:
	/u	Unload
	/h	Help

Initialization file:
	[Functions]
	Name=Program
	[Descriptions]
	Name=Description

	[ShiftFunctions]
	Name=Program
	[ShiftDescriptions]
	Name=Description

'Name' may be one of:

WWW, Email, Search, BrBack, BrForward, BrStop, BrRefresh, BrHistory,
MediaPlayer, Mute, Play, Stop, SkipBack, SkipForward, VolumeDown,
VolumeUp, MyComputer, Calculator, Sleep
---8< (snip) 8<---

As an example, this is the configuration I use at present. My Mitsubishi
keyboard requires the use of the keyboard hook to properly recognise the
multimedia buttons. Try your keyboard with 'InstallHook' set to 0 and if
the buttons don't work properly, give it a go with InstallHook=1. If that
doesn't work, let me know and maybe we can work something out.

---8< (snip) 8<---
[General]
InstallHook=1

[Functions]
WWW="C:\Program Files\Mozilla Firefox\firefox.exe"
Email="C:\Program Files\Mozilla Thunderbird\thunderbird.exe"
Search="C:\Program Files\putty\putty.exe"
Calculator="C:\Program Files\Foobar2000\foobar2000.exe"
MyComputer=C:\Winnt\System32\rundll32.exe user32.dll,LockWorkStation

[ShiftFunctions]
Search="C:\WINNT\system32\cmd.exe"
---8< (snip) 8<---


SOURCE CODE

This program was written to compile with MinGW, a port of GCC to Windows.
You can find out about it at http://www.mingw.org.