
BeatForce 0.1.5
----------------------

BeatForce is a computer dj-ing system featuring two players,
song database, mixer, ...

BeatForce basically works.
Not yet done are some mixer parts, player cue, pitch, speed
beat autosync and beat detection and the sampler.

Beat detection works with a very crude algorithm and a lot of bugs.
You may succeed in using it, but not very likely. In fact it never showed
the right BPM.	:-)
You may try the current algo. by specifying --enable-crude-bpmcount
when calling configure.
I will use another algorithm as soon as I find a good one.

Currently there is an input plugin for MPEG which uses libMAD
and one for WAV.
The libMAD plugin is based on the winamp plugin from Rob Leslie,
the writer of libMAD. Credits to Rob

Output plugins are there for alsa-0.5.x, alsa-final and OSS.
The ESD plugin does not yet work.

The first time BeatForce is started you have to choose your output plugin.
Do this using Menu->Settings->Preferences. On the Sound tab select
an input plugin (alsa,oss,...) and enter a device.
Examples would be: 
  ALSA 0.5.x:	   alsa | default
  ALSA 0.9.x:	   alsa | hw:0,0
  OSS	    :	   oss	| /dev/dsp


Any feedback, suggestions, bug reports to  <beatforce-user@lists.berlios.de>.


Issues:
--------
Never try to remove songs from song database that are currently
in a playlist or playing!
 * some. See TODO


1. INSTALLATION
-----------------
BeatForce needs:
  * pthreads  (of course)
  * libxml (XML library)
  * fftw  (fastest fourier transformation in the west)
  * libvrb	(virtual ringbuffer library)
  * libmad	(mpeg audio decoder library)

The remaining things are straight forward:

./configure
make all
make install



X. DEPENDENCIES
-----------------
pthreads --  should be contained in your linux distribution
libxml	 --  is installed with gnome
fftw --  get from http://www.fftw.org
libvrb	version 0.3, others untested
		get from: http://phil.ipal.org/freeware/vrb/vrb-0.3.0.tar.gz
libmad	anything containing libid3tag should work, tested with 0.14.2b
	get from: http://www.mars.org/home/rob/proj/mpeg/


