Joystick Remote for Winamp - v 2.2
http://www3.sympatico.ca/warpawn/

1.  Overview
2.  Requirements
3.  Instuctions on Use, Setup and Options
4.  Tips
5.  Disclaimer
6.  TroubleShooting
7.  Contact Info


1. Overview

	Joystick Remote for Winamp is exactly what the title says it is, a program that turns your 
gamepad/joystick into a remote control for Winamp.  In short, you can be busy running applications, 
in the middle of an intense game, or anywhere in Windows for that matter, and still have control over 
Winamp without switching to the Winamp window.  The program itself resides only in the system tray 
(next to your clock), making it nearly invisible.  What I do is put Winamp in the system tray also (go to 
Winamp Preferences -> Options -> Display and select System tray only) and then uncheck the Main 
Window, Playlist Editor, Equalizer, and Minibrowser by right clicking on the Winamp system tray icon 
to make them all invisible.  Hence you can run Winamp and Joystick Remote simultaneously without 
cluttering your desktop but at the same time, still maintain control over what you're listening too.  If 
you have a two axis, 4 button joystick (which Joystick Remote was designed for), then you have the 
following commands available to you:  Next/Previous track, play, pause, move playlist hilite up/down, 
play hilited track, exit/start Winamp, volume up/down, fast forward/rewind, shuffle, goto first track, 
toggle windows.


2. Requirements

	- Windows 95/98/NT/2000
	- Gamepad/joystick (4 buttons, gamepads with fewer buttons will have less functionality)
	-WinAmp (works for versions 2.x)


3. Instructions on Use and Setup

Setup:
Just unzip and run the program.  To uninstall, just delete the folder.

FIRST:  Set up your joystick in Windows!!!  Go to Control Panel -> Joysticks/Gaming Options/etc. 
(depending on your version of Windows) and make sure you're joystick/gamepad is set up and displays 
a Status of "OK".  Then be sure to Calibrate and test it.  Do this by selecting your gamepad and clicking 
 properties.

*** Note ***   Joystick Remote works only for the primary joystick on your machine.  Make sure you're 
using joystick number one with Joystick Remote.  If you only have one joystick you don't have to worry 
about this.

Now just run the JoyRemote.exe program and press the following keys to execute their respective 
commands:

Up - volume up
Down - volume down
Left - Previous track
Right - Next track
Button 1 - Play
Button 2 - Pause
Button 3 - Go to top of playlist
Button 4 - Play track currently hilited in your Playlist (Enter)

Additional functionality is gained by holding down button 4  (Note: doing so will not execute the 
command normally associated with button 4):

Button 4 + Up - Move Playlist hilite up
Button 4 + Up - Move Playlist hilite down
Button 4 + Left - Rewind
Button 4 + Right - Fast Forward
Button 4 + Button 1 - Show/Hide Winamp windows (select which windows to control in Options)
Button 4 + Button 2 - Toggle Shuffle play mode
Button 4 + Button 3 - Exit Winamp (if Winamp is running), Start winamp (if winamp is not running)


Options:  (accessed by double clicking the system tray icon or right clicking and selecting options)

Control Visibility
The Options window let's you choose which of the Winamp windows you control with the Button 4 + 
Button 1 Show/Hide command.  Just check the boxes next to the windows you want to control.  

Class Name
The Class Name field and Get Class Name buttons are their for future compatibility.  They contain the 
class names of each of the Winamp Windows and allow you to edit these values.   Doing so haphazardly 
may cause JoyRemote to no longer work.  These values are essential for JoyRemote to find the correct 
Winamp windows.  For Winamp versions 2.x, the values should read Winamp v1.x, Winamp PE, 
Winamp EQ, and Winamp MB.  If your version of Winamp doesn't seem to work with JoyRemote just 
click a Get Class Name button and using your mouse select the ACTUAL winamp window (just activate 
the window).  JoyRemote will detect whichever window you choose and extract the appropriate 
information for it.  Do this for all the Winamp windows, the main window, playlist, equalizer and the 
mini-browser (admittedly, the mini-browser is not by JoyRemote and is there only for the sake of 
completion).


4. Tips:

- Especially during games and when using your whole desktop, keep the Winamp windows hidden so 
that they don't make split second appearances while the command is being executed.

- You can use the Enter function (button 4) and the Goto Top function (button 3) to effectively 
bookmark two places in your playlist.  


5. Disclaimer

This program is provided as is  and WITHOUT WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY 
OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  The user assumes the entire risk of 
using the program, and the author of the program (me) is EXEMPT FROM ANY/ALL LIABILITY THAT MAY 
BE CAUSED FROM THE USE OF THIS PROGRAM WHETHER DIRECTLY OR INDIRECTLY.


6. Troubleshooting

Q.	Nothing happens when I use my joystick.

A.	Is your joystick set up and working?
	Are you running JoyRemote.exe?  Do you see the remote in your taskbar?
	Is Winamp running?  You should be able to start it using button4+button 3.


Q.	Winamp is going crazy switching from song to song and is otherwise performing erradically.

A.	Calibrate your joystick.  You're actually sending all those commands.


Q.	I can exit Winamp using button 4 + button 3 but I can't turn it back on.

A.	In the folder where JoyRemote is, there is a file called Winamp.lnk.  Yes this is just a plain 
Windows shortcut that is executed by pressing button 3 when JoyRemote can't find Winamp.  So a) 
make sure this shortcut is there (othewise create it with the name Winamp.lnk), and b) make sure it is 
pointing to Winamp.exe in the folder you installed Winamp in.  By default this is C:/Program 
Files/Winamp and if this is where you installed Winamp, the link should work fine (execute it manually 
and find out).  NOTE:  if you want to get smart, you can append the name of the playlist you want 
winamp to start playing on the command line.  Or you can just create a shortcut to your favourite 
playlist file (as long as Winamp is associated with this file).


7. Contact Info

Of course questions/comments/problems/help/etc are always welcome, I realize the importance in 
learning from mistakes.  If you do have problems, please give me as much information as you can 
about it (including winamp version) and not just a message that says "I can't get it to work" or else I'll 
just direct you to the Troubleshooting questions above.  Suggestions are always welcome, and are 
entirely the cause of the successive releases.  Also, a decent logo would be nice, if you're feeling 
creative and artistic, drop me a line.

Contact me by email at:
pyian@hotmail.com

JoyRemote Webpage:
http://www3.sympatico.ca/warpawn/

Written June 17, 2001
Modified July 21, 2001