"Simple Keys" plug-in manual (for version 1.0)

General

The Simple Keys plug-in for WinAmp is a tool to control the programm with the help of user-defined hot keys. Its advantages compared to its analogues are following: it starts automatically when you run WinAmp; it closes and is unloaded from memory at the end of WinAmp work; it takes little memory space and system resources; no icons in SysTray and other unnecessary signs of its activity. The plug-in is freeware, so it is distributed absolutely free.

License agreement

You are free to use, copy, share and distribute this version of the Simple Keys
plug-in (hereinafter the Product), documentation and appending files in any way
under the following terms:

- The Product files when distributed should remain unchanged. It must be an
original distribution kit as created by the author.

- The Product is distributed free and not for commercial use. 
You may not charge any fee for the Product in any way and to use the Product
to get any profit without a written certification by the author.

- You may not rent or lease the Product, sell the code of the Product, grant
the Product or any its component not as defined in hereby License agreement.

- Any illegal use of the Product implies tacit and immediate dissolution 
of hereby License agreement.

The product is distributed "as is". The author of the Product will 
not be liable for any consequences, loss of profit or any other kind of loss, 
that may occur while using the product itself and/or together with any 
other software.

If you are using the Product that means you have read hereby License
agreement and fully accept its terms.

Install

To install the plug-in:

Extract the archive into WinAmp plug-ins folder (for example, C:\Program Files\WinAmp\Plugins)
Edit Simple Keys setup file (simple_keys_setting.reg) to specify hot keys you want, using any text editor. You can find detailed procedure in Setup chapter.
Add changes to the registry by running simple_keys_setting.reg file.
Restart WinAmp.

If the plug-in is set up correctly it will appear in "Plug-ins / General Purpose" dialogue of WinAmp setup.

Setup

To set up the plug-in you must change Windows system registry. This can be done in two ways: edit the registry with the help of a Registry editor (for example, regedit.exe of standard Windows applications), or edit the setup file simple_keys_setting.reg using any text editor that does not perform a special formatting (for example, notepad.exe), and import this file settings into the registry. In both cases be aware of the fact that editing the registry can be dangerous to the integrity of the system in case of wrong handling of the parameters. Therefore you should make sure you are making the right changes. It is strongly recommended to make a backup copy of the registry.

Plug-in settings are stored in registry in HKEY_CURRENT_USER\Software\Winamp\Plugins\DenVo\Simple_Keys. The settings are a registry parameter list, each of the parameters binding WinAmp command (for example, start playback) with a specified combination of keys. Any parameter must have a certain name to associate it with the command. This version of the product supports the following names (WinAmp commands in the brackets):

Play (start playback)
Stop (stop playback)
Pause (pause playback)
PlayPause (if playing, pause, otherwise start/resume playback)
NextTrack (go to next track)
PrevTrack (go to previous track)

The names are not case sensitive ( play and PLAY are equivalent).

The parameter value determines the key combination for the command. The value must have DWORD type and its hexadecimal structure should be as follows: 000X00YY, where X contains modifier flags of Control, Alt and Win keys, YY is the hexadecimal virtual key code. You can see modifier flags and key codes in the end of this document.

Below there is the text of an example file simple_keys_setting.reg, with detailed comments for each parameter:

REGEDIT4
; Example Simple Keys plug-in for WinAmp settings file

; Key name
[HKEY_CURRENT_USER\Software\Winamp\Plugins\DenVo\Simple_Keys]

; The parameters give key combinations for WinAmp commands.
; Hexadecimal code format is 000X00YY, 
; where X is modifier flags, YY is virtual key code.

; Stop playback command
; Key combination: Alt+S. Modifier flag: 1. Virtual key code: 53. 
; Hot key code: 00010053 
"Stop"=dword:00010053
; Stop/resume playback command
; Key combination: Alt+P. Modifier flag: 1. Virtual key code: 50. 
; Hot key code: 00010050 
"PlayPause"=dword:00010050
; Previous track command
; Key combination: Win+Left arrow. Modifier flag: 8. Virtual key code: 25. 
; Hot key code: 00080025 
"PrevTrack"=dword:00080025
; Next track command
; Key combination: Win+Right arrow. Modifier flag: 8. Virtual key code: 27. 
; Hot key code: 00080027 
"NextTrack"=dword:00080027

Remove plug-in

To remove plug-in you must close WinAmp, then delete gen_simple_keys.dll file from WinAmp plug-ins folder. You may also delete HKEY_CURRENT_USER\Software\Winamp\Plugins\DenVo\Simple_Keys from the system registry to remove plug-in settings. While editing system registry you should take precautions as described earlier.

Support

You can obtain additional information, send your wishes and error reports about this plug-in if you visit author' site www.denvo.ru

Appendix: constructing hot keys codes

To quick and simple making of plug-in configuration file you can use Online configurator.

Hot key code used as the system registry parameter value, consists of modifier flags (for Shift, Control, Alt and Win keys) and virtual key code. Its hexadecimal format is as follows: 000X00YY, where X contains modifier flags and YY is the virtual key code.

The first table contains modifier flags.

Flag value Shift Control Alt Win

0

1 Pressed

2 Pressed

3 Pressed Pressed

4 Pressed

5 Pressed Pressed

6 Pressed Pressed

7 Pressed Pressed Pressed

8 Pressed

9 Pressed Pressed

A Pressed Pressed

B Pressed Pressed Pressed

C Pressed Pressed

D Pressed Pressed Pressed

E Pressed Pressed Pressed

F Pressed Pressed Pressed Pressed

Flag value	Shift	Control	Alt	Win
0
1			Pressed
2		Pressed
3		Pressed	Pressed
4	Pressed
5	Pressed		Pressed
6	Pressed	Pressed
7	Pressed	Pressed	Pressed
8				Pressed
9			Pressed	Pressed
A		Pressed		Pressed
B		Pressed	Pressed	Pressed
C	Pressed			Pressed
D	Pressed		Pressed	Pressed
E	Pressed	Pressed		Pressed
F	Pressed	Pressed	Pressed	Pressed

The second table contains virtual key cosdes.

High-order digit Low-order digit

0 1 2 3 4 5 6 7 8 9 A B C D E F

0 Bkspc Tab Enter

1 Shift Ctrl Alt Pause Caps Esc

2 Space PgUp PgDn End Home Left Up Right Down PrScr Ins Del

3 0 1 2 3 4 5 6 7 8 9

4 A B C D E F G H I J K L M N O

5 P Q R S T U V W X Y Z LWin RWin Apps Sleep

6 0 1 2 3 4 5 6 7 8 9 * + - . /

7 F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16

8 F17 F18 F19 F20 F21 F22 F23 F24

9 Num Scrl

A LShift RShift LCtrl RCtrl LAlt RAlt Back Fwd Refr Stop Search Fav Home Mute Vol- Vol+

B Next Prev Stop PlPaus Mail Media App1 App2 ; : + = , < - = . > / ?

C ` ~

D [ { \ | ] } ' "

High-order digit	Low-order digit
0	1	2	3	4	5	6	7	8	9	A	B	C	D	E	F
0									Bkspc	Tab				Enter
1	Shift	Ctrl	Alt	Pause	Caps							Esc
2	Space	PgUp	PgDn	End	Home	Left	Up	Right	Down				PrScr	Ins	Del
3	0	1	2	3	4	5	6	7	8	9
4		A	B	C	D	E	F	G	H	I	J	K	L	M	N	O
5	P	Q	R	S	T	U	V	W	X	Y	Z	LWin	RWin	Apps		Sleep
6	0	1	2	3	4	5	6	7	8	9	*	+		-	.	/
7	F1	F2	F3	F4	F5	F6	F7	F8	F9	F10	F11	F12	F13	F14	F15	F16
8	F17	F18	F19	F20	F21	F22	F23	F24
9	Num	Scrl
A	LShift	RShift	LCtrl	RCtrl	LAlt	RAlt	Back	Fwd	Refr	Stop	Search	Fav	Home	Mute	Vol-	Vol+
B	Next	Prev	Stop	PlPaus	Mail	Media	App1	App2			; :	+ =	, <	- =	. >	/ ?
C	` ~
D												[ {	\ \|	] }	' "

Colours denote different types of keys:

Alt System key

* Numeric keyboard key

Media Multimedia key (supported by Win2k/XP)

Constructing hot key codes examples

Alt+P combination. Modifier flag: 1. Virtual key code: 50. Hot key code: 00010050 (hexadecimal).

Ctrl+Win+Del combination. Modifier flag: A. Virtual key code: 2E. Hot key code: 000A002E (hexadecimal).

Alt	System key
*	Numeric keyboard key
Media	Multimedia key (supported by Win2k/XP)