Winamp Control Center

File Release Notes and Changelog

Release Name: 1.0.5

Notes:
Winamp Control Center
---------------------

Author  - drag0neye <webmaster@wcc.cx>
Website - http://www.wcc.cx/
Date    - 2/23/00

INTRODUCTION
--------------------

This is an entirely cgi based server-side program that allows users to remotely control
Winamp (http://www.winamp.com/) through a web browser. The program was written in Visual
Basic 5.0 and as far as I know will only run on Windows-based operating systems. The 
main use for this application is for ShoutCast (http://www.shoutcast.com/) DJs to allow 
listeners to play their favorite song or to remotely DJ from another computer. It is
licensed under the GNU General Public License, please read the included gnu.txt file for
details.

INSTRUCTIONS
--------------------

This cgi program will only run on WindowsNT/9X based computers! Most web servers require 
that the wcc.exe file (or whatever you named it to) is in the cgi-bin/ directory so it 
executes instead of trying to send it to the client. The images probably need to be 
placed outside of the cgi-bin/ directory (so the server doesn't try to execute them). 
The template file(s) can usually be put in the same directory as the executable, 
but it isn't required. Make sure you change the configuration file to point to the 
correct locations. Next, make a link on your website that points to the executable.
 Example: http://www.yourwebsite.com/cgi-bin/wcc/wcc.exe

TEMPLATE MODIFYING
--------------------

WCC comes with two default templates. One is for full-screen output, and the other (ssi) 
is for WCC to be used as a Server-Side Include. Check your webserver documentation on 
how to setup SSI (if your webserver supports it). Make sure you set the .conf file to 
point to the correct location of the template file you wish to use. If you want to edit 
the template files or make your own, here is a list of the variables that are recognized: 
(Use the <!-- VariableName --> format to use these variables in a template)

AmpStatus
AmpVersion
SongLength
Khz
KBps
Songname
Listbox?[ListBox height]
Play?[image path]
Pause?[image path]
Stop?[image path]
Forward?[image path]
Previous?[image path]
AppPath

FAQ (must read!!!)
--------------------

Q. The graphics don't show up!
A. There are two possible problems here. Most likely either the configuration file 
   doesn't point to the right graphic directory, or your graphics are in the cgi-bin 
   directory and your web server doesn't like that.

Q. People are messing with my Winamp!
A. You will probably want to password protect this program. Check the FAQ for your 
   webserver on how to do this or e-mail me and I can help you out.

Q. The SSI include doesn't work!
A. Most likely (99.9% of the time) the problem is with the web server setup. If you 
   think that it might be a problem with Winamp Control Center e-mail me with the 
   details.


Changes:
1.0.5 - I finally fixed the fscking NT compatibility issue.      
          Swapped the FindWindow() API call out for something I    
          found on Micro$oft's site. Later I was informed that you 
          can't pass zero to API calls that want null strings.     
          (And how many years have I been programming in VB?       
          Geez...). Also, I totally rewrote the header and footer  
          setup, it now uses one template file that is parsed by   
          wcc to provide *fully customizable output*. Awww yeah.