Modification of the KVIrc 'mediaplayer' module to provide support
for different players (Winamp 2/3/5, foobar2000, iTunes, QMP/QCD,
MediaMonkey, Apollo) via AMIP now playing plug-in.

(c) Serge Baranov, 2007, http://amip.tools-for.net

Requirements:
- AMIP 2.61+
- AMIP Configurator (optional)
- KVIrc 3.2.6 or later


Installation instructions:

IF YOU KVIRC VERSION/BUILD IS LATER THAN 2007-05-15 IT SHOULD ALREADY
HAVE AMIP SUPPORT OUT OF THE BOX, ALL YOU NEED IS TO COPY ac.dll AND
ac.ini INTO THE INSTALLATION DIRECTORY.

IF YOU ARE USING OLDER BUILD, SEE BELOW:

- Close KVIrc
- Unpack all the files into KVIRC_HOME directory preserving directories.

  YOU MUST OVERWRITE EXISTING kvimediaplayer.dll FILE IN MODULES SUBDIR
  ONLY IN CASE YOUR KVIRC BUILD DOESN'T ALREADY HAVE AMIP SUPPORT AND
  IS RELEASED BEFORE 2007-05-15.

- Run KVIrc
- Open Settings | Configure KVIrc | General options | Sound, Sound System
  tab, in the Media Player control group select 'amip' from the list
- Restart KVirc


Quick start:
  Type the following:

  /alias(np) { me is now playing: $mediaplayer.nowPlaying(); }

  This should add /np alias, now type

  /np

  to announce currently playing song in IRC.

  You can also install some script like Twins Media Player which should
  now work with your player automatically.

Usage:
- See help for KVirc 'mediaplayer' module, AMIP provides
  almost all functionality, except playMrl and equalizer functions.
  
- In addtion AMIP provides the following KVIrc mediaplayer module
  command:
  
  mediaplayer.amipExec
  
  This command should be followed by one of the AMIP commands listed at
  http://amip.tools-for.net/wiki/manual/amip#api_commands, like:
  
  mediaplayer.amipExec "control pause"
  
- There is also amipEval function:
  
  $mediaplayer.amipEval("amip eval function");, like:
  $mediaplayer.amipEval("rawformat \%name (\%4)");
  
  Note that you should escape % with \ so that KVirc  doesn't try to interpret 
  them before sending to AMIP.
  

Toubleshooting:
- AMIP must be running
- Server/API must be enabled in AMIP Configurator (default)
- AMIP must be listening on 127.0.0.1:60333 for client connections (default)
- If this port is busy, change AMIP settings to use different port and adjust
  ac.ini according to these settings.
