
----------AMPSIG + AMPSTATS ----------

---CONTENTS---
1)ABOUT
2)SUPPORT
3)PRE-INSTALLATION
4)CONFIGURE THE PLUGIN
5)INSTALLATION
6)CUSTOMISATION
7)USAGE
8)COPYRIGHT

note: before even attempting this, MAKESURE YOUR WEBSERVER HAS THE GD PHP EXTENSION ENABLED, AND IF YOU
PLAN ON USING SIGSTATS, YOU ALSO NEED A MYSQL DATABASE!?!?!?!?


---ABOUT---

AMPSIG:
-now playing dynamic signature, works for media players, winamp 2/5, winamp 3, Apollo, QCD, foobar2000 and iTunes
-Utilizes best available now playing plugin, AMIP
-if playing a song, displays current song playing, and previous song played.
-if winamp is closed/stopped/Played, displays message telling viewers winamp's Status, and displays last played song.
-supports multiple background templates.
-resizes itself depending on song length, no songs with the ends chopped off =D
-displays to the viewer of the sig, the completetion percentage of the song you are listening to.
-displays to the viewer of the sig your computer uptime.
-displays to the viewer of the sig their IP address.
-displays to the viewer of the sig their Operating System.
-displays to the viewer of the sig their Internet Browser.
-displays local time of whos ever sig it is.
-counts how many times sig has been loaded in a browser.
-displays to the viewer of the sig how many times the sig has been viewed.
--template adding function now improved.

SIGSTATS:
-online music database, show people what you've been listening to.
-uses amp.php to submit data, so it's compatible with all the same players.
-no need to have more than one plugin installed, uses same plugin that you choose for AMPSIG
-calculates which artists you've been listening to the most, and displays top 10.
-calculates which songs you've been listening to the most, and displays top 10.
-displays last 50 songs you listened to, and how long ago you listened to them.
-completely customisable using config.php and style.css
-easy to install, comes with automatic MySQL installer.



---PRE-INSTALLATION---

Before trying to install AMPSIG /and SIGSTATS, you must first download the required player plugin that posts
your song data to the script, the plugin is called AMIP, details on how to configure come later, but for now,
download AMIP, the AMIP configurator, and also you will need cURL to actually HTTP post the data to ampsig,
though the creator of AMIP has promised us that a built in http post function will be included with a 
future version of AMIP.

Download "AMIP":
http://amip.tools-for.net/index.php?content=download

Download "cURL"(required for AMIP to work):
http://curl.haxx.se/dlwiz/?type=bin

note: finish the download wizard to get the package you require, enter your OS, then select "Generic",
	 then select your OS version, then if you have to select something for CPU, i'm sure you already
	 know what you have to select =P then downlaod the package that has "SSL DISABLED"!!!
	 
Download "AMIP Configurator v0.21"(not required, but makes getting this to work ALOT easier):
http://amip.tools-for.net/index.php?content=download

now you have the plugins downloaded, goto your downloaded "ampsig" directory, remove the folder local,
the file sin this folder need to be on your computer, now upload the "ampsig" directory to your webserver.

      
---CONFIGURE THE PLUGIN---

OK, now we need to setup the plugin to post to teh script, so install them, and put cURL.exe somewhere where you
can remember where it is, eg : C:\ampsig\curl.exe , also it mgiht be  agood idea to store the files from the "local"
folder here to, so you should have something like this:
C:\ampsig\curl.exe
C:\ampsig\utu.exe
C:\ampsig\libcurl.dll
now we can get on with configuring amip :)


AMIP:
1)Goto the plugin preferences, and on the "general" tab, check "enable plugin".
2)Now goto the "Callbacks/Web" tab in amip, and enter the following into each status box:
(replacing "USERNAME" + "PASSWORD", with what you wish to use for your password. ALSO it all HAS to be
on one line)

PLAY/PAUSE/STOP:
/exec:(C:\ampsig\curl.exe) -d "Title1=%2&Artist1=%1&user=USERNAME&pass=PASSWORD&Playing=%tstat&Length=%sl&Pos=%psec" http://path/to/ampsig/amp.php
  
START:
/exec:(C:\ampsig\utu.exe) USERNAME PASSWORD http://path/to/ampsig/amp.php

EXIT:
/exec:(C:\ampsig\curl.exe) -d "Title1=%2&Artist1=%1&user=USERNAME&pass=PASSWORD&Playing=closed&Length=%sl&Pos=%psec" http://path/to/ampsig/amp.php

5)click "apply" and then "OK"
6)onto installation of AMPSIG+SIGSTATS


---INSTALLATION---

AMPSIG

1)open config.php(found in config directory) in a text editor, and edit your preferences, and also
 set your password and username, makesure it's exactly the same as what you entered in the plugin,
 it's case sensitive to =P save the document when your done.
2)makesure count.txt and amp.ini (both found in data directory) are world writable by the server(not neccasary
on windows servers).
3)start playing a song, and goto http://your.domain.com/ampsig/amp.php
4)you're done, unless you have a MySQL database and want to use SIGSTATS, don't set the $sigstats variable
  to true.
  
AMPSIG + SIGSTATS

1)do steps 1+2 of the above installation steps.
2)set the $sigstats variable to "true", and enter your MySQL details,in config.php, save the file.
3)in your browser, goto "http://your.domain.com/ampsig/" without the quotes.
4)if you get "created tables successfully", you're ready to go, if not you need to sort out your
  MySQL details in config.php, and makesure you have a MySQL server lol =P
5)start playing a song, and goto http://your.domain.com/ampsig/sigstats.php to check to see if it
  is working.
6)also goto http://your.domain.com/ampsig/amp.php to makesure the sig is working
7)you're finished :)

if you experience any troubles when installing please visit:
http://corz.org/dev/php/workshop/bael+corz.dynamic.php.sig.page.php
and post a comment,


---CUSTOMISATION---

you can completely customise both AMPSIG+SIGSTATS to how you want them to look, u can create new 
background templates for ampsig, and completely personalise how you want it to look, check out
my example in the templates directory, there are template installation instructions inside
config.php. to customise AMPSTATS, you need to use parts of config.php and also style.css, if you 
wish to change the background colour you have to edit line 35 of ampstats.php, you can also
create a new background images, and have that displayed in the background, checkout my template
example in the config directory.


---USAGE---

to use the sig in forums, just treat the .php file as you would an image, eg, put it in image tags:
[img]http://your.domain.com/ampsig/amp.php[/img]

for forums that don't allow .php extensions, use this instead:
[img]http://your.domain.com/ampsig/amp.php/amp.png[/img]

and if you have ampstats enabled, why not go with:
[url=http://your.domain.com/ampsig/sigstats.php][img]http://your.domain.com/ampsig/amp.php[/img][/url]

You can also tryout:
http://your.domain.com/ampsig/mini_sigstats.php
aswell if you have the database enabled :)


---COPYRIGHT---

AMPSTATS 1.0 
 Ryan Rowland 2005
http://baelsdimension.ath.cx

AMPSIG
 Ryan Rowland 2005
http://baelsdimension.ath.cx

uTu (upTime update)
 corz.org 2005

original now playing script
 corz.org 2005

Choonstats 0.9
 Sebastian Conn 2005
www.spiraloz.com