Remote Speakers Output Plug-In
Stream audio from Winamp or MediaMonkey to an AirPort Express (aka AirTunes)

Copyright (c) 2006-2008  Eric Milles

http://emilles.dyndns.org/software/out_apx.html



REQUIREMENTS
------------
1) Apple AirPort Express (http://www.apple.com/airportexpress/)

2) Nullsoft Winamp (http://www.winamp.com/)
     or
   Ventis Media MediaMonkey (http://www.mediamonkey.com/)

3) Keyspan Express Remote (http://www.keyspan.com/products/usb/urm17a/)
     (necessary only for remote control) 



INSTALLATION
------------
Close player.  Uninstall any previous versions of the plug-in.  Run the
installer (setup.msi), choosing the player's directory--which is usually
C:\Program Files\<player name>--as the destination.

Open the following ports on your firewall for incoming traffic:
3689/TCP (necessary only for remote control)
5353/UDP (necessary for discovery of remote speakers)



CONFIGURATION
-------------
Open player options dialog and select Output Plug-ins.  Select Remote Speakers
output from the list of output plug-ins.  Click Configure.  There are three
options that can be configured for the plug-in:

1) Remote speakers - list of discovered remote speakers on local subnet.  This
    list updates automatically as remote speakers come and go.

2) Allow player to control volume of remote speakers - if checked, player's
    volume bar (or knob depending on your choice of skin) will influence the
    playback volume of the remote speakers.  If unchecked, the AirPort Express
    will playback audio at full volume.

3) Send flush to remote speakers on pause - if checked, the output plug-in will
    instruct the remote speakers to flush its playback buffer on pause.  This
    causes playback to stop more quickly but causes some clipping of the track
    when playback is resumed.  If unchecked, no flush message will be sent so
    playback will take a few seconds to halt but there will not be any clipping
    of the track when playback is resumed.



REGISTRATION
------------
Visit the plug-in's main page with your site code to purchase a license and
receive an activation code:
    http://emilles.dyndns.org/software/out_apx.html

If you have already purchased a license and are experiencing problems or need to
setup on a new workstation, send  me an email (registration@emilles.dyndns.org).



KNOWN ISSUES
------------
* Playback timer is hurried when the remote speakers playback buffer is being
    filled.  This could be fixed if I was able to correctly determine the
    current latency of the AirPort Express.  Maybe someday this will be fixed.

* Winamp and MediaMonkey's default behavior when an output plug-in is unable to
    play a track is to move on to the next track and try to play it.  This isn't
    so good from the user's perspective when the plug-in is unable to connect to
    the selected remote speakers.  Connect dialogs keep popping up over and over
    as tracks in the playlist are advanced through by the player.



QUESTIONS AND COMMENTS
----------------------
Visit the plug-in's frequently asked questions page first to see if your question
or comment has already been answered:
    http://emilles.dyndns.org/software/out_apx/faq.html.

I encourage you to report any problems you find with the plug-in or suggest any
features you would like to see added in future versions.  Send me an email
(support@emilles.dyndns.org).  For problem reports, include the error message and
error code you receive, the version of the player and Windows you are running
with and the firmware version of your AirPort Express (if you know it) along with
a complete description of what you were doing when the error occurred.
