HLamp 1.20
Created by Disk2 (disk2@cscentral.com)
http://www.cscentral.com/disk2/hlamp


INTRODUCTION
============

HLamp is a small WinAMP plug-in that allows Half-Life players to control WinAMP from inside Half-Life using the Command Menu or bound keys. With HLamp you can play, pause, stop, change the volume, load songs and Shoutcast streams, and much more, all from within Half-Life.


REQUIREMENTS
============

- Any version of Windows - Windows 95, 98, Millennium, NT, 2000, and XP should run HLamp fine. 

- Half-Life 1.1.1.0 - No other versions of Half-Life will work with HLamp. 

- Any recent version of WinAMP will work fine. Go to www.winamp.com for the latest version.


WINAMP 2.X INSTALLATION
=======================

1. Extract GEN_HLamp.dll to your WinAMP\Plugins directory. A common location for the Plugins directory is C:\Program Files\WinAMP\Plugins. 

2. Restart WinAMP.

3. Copy commandmenu.txt to your Counter-Strike directory. For example, "C:\Sierra\Half-Life\cstrike\commandmenu.txt". If you are using DOD, TFC, or another mod then youll have to use the command menus from the Other Command Menus directory.

4. This step is optional, but it makes HLamp much more useful. You can add songs to your Command Menu by editing the bottom of commandmenu.txt in your mods directory. Ive provided a couple examples at the bottom of the Command Menus included with HLamp. You can add your own entries. Follow the example.

Note: If you have a custom commandmenu.txt just copy and paste the WinAMP section to the end of your commandmenu.txt. If you have a custom command menu you should know how to do this. If you dont know how, kindly refrain from asking me. Ask on the HLamp forums. If you dont know what Im talking about, ignore this note.

5. Bind a key to +commandmenu. For example, go to the console type, "bind P +commandmenu".

6. Make sure WinAMP and Half-Life are running. Press the key you bound to +commandmenu. The Command Menu will pop up. Use the menu items in the WinAMP menu to control WinAMP.


WINAMP 3.X INSTALLATION
=======================

1. Download and install the WinAMP 2 Plug-in Manager from http://members.telocity.com/~schweitn/wa3/wa2mgr/index.html

2. Create a new directory called C:\HLamp\ and extract GEN_HLamp.dll to that directory. C:\HLamp\GEN_HLamp.dll 

3. Run WinAMP 3 and press Ctrl+P. Scroll down to Winamp 2x Plugins in the list on the left. "Type C:\HLamp\" in the New Search Path box located in the Plugin Path tab. Click Add. 

4. Restart WinAMP.

5. Copy commandmenu.txt to your Counter-Strike directory. For example, "C:\Sierra\Half-Life\cstrike\commandmenu.txt". If you are using DOD, TFC, or another mod then youll have to use the command menus from the Other Command Menus directory.

6. This step is optional, but it makes HLamp much more useful. You can add songs to your Command Menu by editing the bottom of commandmenu.txt in your mods directory. Ive provided a couple examples at the bottom of the Command Menus included with HLamp. You can add your own entries. Follow the example.

Note: If you have a custom commandmenu.txt just copy and paste the WinAMP section to the end of your commandmenu.txt. If you have a custom command menu you should know how to do this. If you dont know how, kindly refrain from asking me. Ask on the HLamp forums. If you dont know what Im talking about, ignore this note.

7. Bind a key to +commandmenu. For example, go to the console type, "bind P +commandmenu".

8. Make sure WinAMP and Half-Life are running. Press the key you bound to +commandmenu. The Command Menu will pop up. Use the menu items in the WinAMP menu to control WinAMP.


LEGAL INFORMATION
=================

This software is provided as-is, without express or implied warranty. In no case will the author be held liable for any damages arising from the use of this software. This software may be freely redistributed, but it may not be modified in any way without the authors permission.

HLamp may not be packaged with other software (or anything else for that matter) without my consent. If youd like to include HLamp with your script or program just email me (disk2@cscentral.com) and Ill most likely say OK. I just like to keep track of which scripts include HLamp.

By using HLamp, you agree to abide by the terms listed above.


MISCELLANEOUS
=============

Thanks to [PacoM]Noble[CSR] (Clan PacoM, #PacoM on GamesNET) for asking me to write this plug-in. Thanks to [PacoM]Marsellus[CSR] and Keyser Soze for a few great feature suggestions. As always, thanks to CS Centrals uber-1337 German Webmaster, Sebastian, for hosting HLamp on CS Central (http://www.cscentral.com). 

And finally, thanks to Brutus, Spellbinder, Crack, the CS Radio guild, Clan PacoM, Piro!!!, and whoever else I forgot to put in the readme (sorry!) for beta testing HLamp. Did you beta test HLamp? Not in the readme? Send me hate mail! hatemail@cscentral.com.