Configure plug-in

Setup basics

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 below on this page.

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

Constructing hot keys codes

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.

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

Virtual key codes

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)

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).

 

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