WinampRC V1.0 - Winamp Remote Control
Copyright (C) 2001 Jean-michel Bunouf 

The program is freely distributable.  
This means that you have permission to use, copy or distribute 
this software and its documentation.  You do not have permission 
to charge anything other than a duplication fee for distributing 
copies of this software.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  


Important :
-----------

This  program  is based on a Winamp general purpose  plugin 
that allowed Winamp to be controlled via a serial port. More
information on the Winamp plugin can be found at :
[http://henrik.husted.net/winamp.htm]

This  plugin works with Winamp 2.XX. This plugin  DOES  NOT
WORK  with Winamp 3 since they changed the interface to the 
program.



Thanks to :
-----------

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
	  PMS SYSTEM SOFTWARE, THE site for Avigo fans :
		[www.pmssystem.de/avigo.htm]
*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

Gerard Vermeulen for his Freeware SDK,
Charles Randy Gill and Kai Nothdurft for AVIGO GUI Library,
And to all Avigo developers/owners.



Winamp Remote Control :
-----------------------

... Well, if Avigo couldn't play mp3s,
it should at least be able to control a mp3 player...

"Winamp Remote Control" lets you control Winamp through IR 
or  serial port. You can send  commands like: start, stop, 
increase the volume, play a specific play list etc. It also 
display the current song title. 

A smart way to control Winamp. (I don't have to find it 
when I'm programming Avigo with many windows on desktop ;)

Buttons are self explanatory.


Tips : 
------       

Key up = previous track
Key down = next track


Installation :
--------------

1) Close Winamp if necessary.

2) Copy "gen_SerialControl.dll" and "serialcontrol.ini" to 
   your Winamp plug-in directory (eg: c:\program files\
   winamp\plugin).

3) Start  Winamp.  In  Winamp open the  preference  dialog. 
   select 'general purpose' in the plug-ins section. Select 
   SerialControl and click on 'configure'. 
   [com 1/2/3/4 -9600 bauds-8b-N-1 stop]

4) Choose which COM port you want to use with SerialControl.
   (usual :  Avigo  craddle serial port).  Close  preference 
   dialog.

   Note : The  COM  port cannot be used for  other  purposes  
   (ex.  :  Avigo Manager ) while Winamp with  SerialControl 
   is using it. 

5) Launch  WinampRC  on Avigo. If you choose the right  port 
   number,  you  can control Winamp and you should  see  the 
   song title in the Winamp info window



Play list programmation :
-------------------------

"List 1...6" buttons allows to choose between 6 playlist. For
this purpose, you must configure SerialControl. 

1) On  Avigo,  select "Learn mode" on the menu. It stops  the 
   Avigo  cyclic  "SONG INFO"  request and allows to  program 
   play lists.

2) On  "SerialControl  Setting" select "Winamp"  ( near  "COM
   port").

3) Use  the  'add play list' to add a predefined  play  list. 
   Select on the list your "xxxx.m3u"  you added and click on 
   'learn' . A message box appears :"Please send the  command 
   now". 

4) Click  "List 1...6"  button  on  Avigo.  The  message  box 
   disappear and a check is visible. Close preference dialog.

5) On  Avigo,  select  "Normal mode" on the menu. It  restart 
   the Avigo  cyclic  "SONG INFO"  request. When you click on
   the "List x", the play list is loaded. Note that adding  a 
   play  list while Winamp is playing will clear the  current 
   one  and replace it with the new. Adding a play list  will 
   not  cause Winamp to start playing the new list, you  have 
   to send a 'play' command.


Stop using WinampRC :
---------------------

1) Finally    :    remove     "gen_SerialControl.dll"     and 
   "serialcontrol.ini" from your Winamp plug-in directory. 

2) Temporarily : Uncheck AutoOpen on  "SerialControl  Setting" 
   ("AutoOpen"  opens  the  com  port  each  time  Winamp  is 
   started). You can also close the com port with "close now"
   button


As  usual,  you can find the program source in the  zip  file.
Enjoy !


Jean-michel Bunouf
E-mail:[jeanmichel.bunouf@oreka.com]
8 avril 2001


Your support :
--------------

You can send me a postcard at the following address:

Jean-michel Bunouf
Residence Alsace 
7, rue Denfert Rochereau
78200 Mantes la jolie
France


Files included in voiceclock.ZIP :
----------------------------------

readme.txt.............. this information file
source.zip.............. source files  (*)SEE BELOW
WinampRC.app............ compiled version
gen_SerialControl.dll... \ Goes in your Winamp plugins folder
serialcontrol.ini....... /


(*) Files included in source.zip :
----------------------------------

readme.txt ..... This information file
makefile........ \ for Freeware SDK compilation
WinampRC.def.... /
WinampRC.c...... C main file

