
QuickStart instructions for BeatForce
--------------------------------------

1. You will have to download and install the necessary dependencies if
they are not installed with your distribution.
  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 (version >= 0.14.2b) should work, 
		 tested with 0.14.2b,
		 get from: http://www.mars.org/home/rob/proj/mpeg/

 Note: If you download the rpm packages or install them from your distro CD
       you have to download/install the [packagename]-devel packages too.


2. Build and install BeatForce:
  tar xvfI BeatForce-[VERSION].tar.bz2
  cd BeatForce-[VERSION]
  ./configure
  make all
  make install

 Note: This will install BeatForce in prefix /usr .
       If you want to install it in eg /opt/BeatForce, 
	add the parameter --prefix=/opt/BeatForce to ./configure .

3. Start BeatForce
  Start BeatForce.
  When BeatForce starts it will notice you that it wasn't able to find a
  configuration file and that you have to set your output device,
  which we will do now.

  Setting the output device:
    On the main window select the menu Settings->Preferences.
    Go to the Sound tab.
    At group MASTER select your plugin (alsa/oss) (esd doesn't work yet)
    and enter your device.

    SoundSystem    Plugin | Device
    -----------------------------------
    ALSA 0.5.x:      alsa | default
    ALSA 0.9.x:      alsa | hw:0,0
    OSS       :      oss  | /dev/dsp

  You can leave the remaining default settings as they are.
  If you experience "gaps" in the sound output try setting Ringbuffer Size
  higher.

  Now press OK.
  A dialog will notice you to restart BeatForce which we will do.
  Select File->Exit.

  Start BeatForce again.
  

4. Adding songs to the Song Database
  On the main window click the togglebutton SongDB. The Song Database window
  should appear.
  On the "Category" tree select "Database".
  Now you can use "+" or "Properties->Add Dir Struct" to add Songs to the
  database.

5. Adding songs to the playlist
  Having completed step 4 select "Full DB" in the "Category" tree.
  Some songs should appear in the (right hand) list.
  Use the right(!!) mouse button to drag them to the player playlist.

6. Setting up the mixer
  I think the mixer is relatively self-explaining.
  Simply set the Player 0/Player 1 to  -0 (using the vertical fader).


7. HAVE FUN
  
  