AMIP integration for Miranda IM (MSP based)
(c) Serge Baranov, 2007
Version 1.0
http://amip.tools-for.net

FEATURES
====================
This plug-in provides integration with the AMIP now playing plug-in for Miranda
IM. Following features are available:

- set ICQ XStatus to currently playing song title
- set MSN and Yahoo away message to playing song
- handle /np command in message windows and replace it with song info
- /ac command to control playback in your player (also works remotely, so that
  you can control your player with messages from another ICQ)
- if PopUp plug-in is installed the script will display nice pop-up with song
- bundled SVN build of MSP (mBot) plug-in and PHP 5.2.4 DLL (minimal build)
  (fixed bug with console window appeared when using mBot)


INSTALLATION
====================
Integration is available in 2 different packages: automatic installer and zip
file for manual installation. Which one to use?

If you don't have MSP (mBot) plug-in already, it's recommended to use the
installer package. Just run and specify your Miranda directory if not detected
automatically. Uninstaller is also created and it will remove everything
related to AMIP and MSP (mBot) from Miranda directory. So, if you have other
MSP scripts installed, use with care.

Zipped package contains everything you need for manual installation, whether
you already have MSP or not.

If you don't have MSP, just unpack the zip into Miranda directory and you are
all set.

If you already have MSP and don't whant to use my version, then you need to
copy only the following files:

  ac.dll
  mbot\extensions\php_amip_514.dll (you MUST rename it to php_amip.dll as mBot
                                    comes with PHP 5.1.4 DLL by default, if you
                                    have 5.2.x PHP DLL, then use php_amip.dll).
  mbot\scripts\autoload\amip.php
  
Now open mbot\config\mbot.xml and add php_amip.dll to extensions, like:
  <!-- extensions go here !-->
  <extension>php_amip.dll</extension>


USAGE
====================
Start Miranda, set your XStatus to "Listening to Music", change song in the
player. Within one minute the status should be set to the song info.

Type /np in the messge window to send song info to your friend.

Type '/ac control pause' to pause player (without quotes) and again
to unpause, see http://amip.tools-for.net/wiki/manual/amip#api_commands for the
complete list of available commands which you can use.

Yahoo and MSN away messages will be set to song info automatically.


CUSTOMIZATION
====================
If you want to change song info format, open mbot\scripts\autoload\amip.php
file and see the format strings in the beginning. Note that you can use AMIP
variables there, but be sureto correctly escape special characters if needed
so that it makes a valid PHP code, otherwise the script will fail to load.

You can also enable/disable certain functionality, try to guess from the code.


CHANGES
====================
1.0
  - initial public release
