PROJECTM README FILE
--------------------------------

QUICK OVERVIEW
----------------------
projectM started initially as a reimplementation of the Win32/DirectX based music visualizer Milkdrop under Linux/SDL/OpenGl/XMMS. 
It currently supports up to Milkdrop 1.04b presets, but there are some bugs with certain presets containing 1.04 features This project
is 100% GPL'ed - feel free to use the code for whatever. 

WARNING
------------------------
This is a beta release. There some known bugs, and likely unknown ones. 
Please report bugs at the project web page at source forge: http://xmms-projectm.sourceforge.net

INSTALL
------------------------

]1] Install SDL 1.3 branch

(Un)fortunately there is a special feature in a development branch of SDL dubbed "branch_1_3_x" that projectM requires to handle
different texture sizes and window resizing. This code is under CVS at SDL's sourceforge site, and has not been thoroughly
tested. However, the developers have found it stable enough to merit installation. We provide a source tarball of a recent 
CVS version on our website (http://xmms-projectm.sourceforge.net). 


Once you have downloaded the tarball SDL-1.3.0.tar.gz do the following:

As usual, run

sh> ./configure

followed by

sh> make

and as root

sh> make install

NOTE: this will install SDL in /usr/local, so when you compile projectM make sure that it finds SDL-1.3 and
not SDL-1.2 (which is likely in /usr with most distributions). Hopefully the configure script will verify this
automatically for you. To force SDL into /usr, type 

./configure --prefix=/usr

followed by typical make and make install.

[2] Install projectM

If you haven't already, download the latest tarball release from http://xmms-projectm.sourceforge.net.

Then run

sh> ./configure

followed by

sh> make

and as root

sh> make install

This will install projectM into XMMS's Visualization plugin directory. projectM's configuration
files, including the default packaged presets are in /etc/projectM.

Enable projectM by loading XMMS and pressing CTRL-v. This will bring up the vis plugin menu. Highlight
projectM in the list (if it's not there something went wrong during installation), and click the enable
button. Sit back and enjoy the trippy visuals...

CONFIGURE
----------

edit /etc/projectM/config


CREDIT / CONTACT
------------------

Main Developers:

Carmelo Piccione: w1z7ard@sourceforge.net
Peter Sperl: psperl@sourceforge.net

Advice / Support:
Roger Dannenberg (rbd@cs.cmu.edu)




