Jajouka INSTALL (0.66 "Train")
=============== ==============

Jajouka-GUI Requirements
========================
* python >= 2.4  (http://www.python.org)
* pygtk2 >= 2.6.0  (http://www.pygtk.org)
* mysql-python >= 0.9.2  (http://sourceforge.net/projects/mysql-python/)

Jajouka-Server Requirements
===========================
* giantdisc >= 1.40 (http://www.giantdisc.org)
* python >= 2.4  (http://www.python.org)
* gnump3d >= 2.8.0 (http://www.gnu.org/software/gnump3d/)
* pyogg >= 1.1 and pyvorbis >= 1.1  (http://www.andrewchatham.com/pyogg/)
* mp3info >= 0.8.4 (http://www.ibiblio.org/mp3info)



Installation Notes
==================
GNU/Linux:
    As root (superuser):

    Extract the contents of the tarball into a suitable folder, then enter:
        ./install           (installs full version)
      or
        ./install-server    (installs server-only version)

    To run (as a normal user) start the app with:
        /usr/bin/jajouka

    and the giantdisc rescanner can be started (without the GUI) with:
        /usr/bin/jajouka-rescan

    and the jajouka server can be started (as the giantdisc music user) with:
        /usr/bin/jajouka-server-start

    * Anyone want to contribute redhat / mandrake / suse / ubuntu / debian packages?


Gentoo-Linux:
    1) If you've not already setup a local portage area then:

    1.1) In the /etc/make.conf file, add something like:
            PORTDIR_OVERLAY=/usr/local/portage

    1.2) Make a directory for jajouka:
            mkdir -p /usr/local/portage/media-sound/jajouka
          or
            mkdir -p /usr/local/portage/media-sound/jajouka-server

    2) Copy the jajouka.0.65.ebuild file to your local portage area, eg:
            cp jajouka.0.65.ebuild /usr/local/portage/media-sound/jajouka
        or
            cp jajouka-rescan.0.65.ebuild /usr/local/portage/media-sound/jajouka-server

    3) Merge jajouka:
            emerge --digest /usr/local/portage/media-sound/jajouka/jajouka.0.65.ebuild
        or
            emerge --digest /usr/local/portage/media-sound/jajouka-rescan/jajouka-rescan.0.65.ebuild


Windows:
Either:
    1) Download & run the latest (must be >= 2.6) GTK runtime from :
            http://gladewin32.sourceforge.net/
    2) Download & run the jajouka installer (jajouka-0.65.setup.exe)
    3) See "using jajouka on windows with a remote giantdisc server" in the README
       file for more information.

or (to install the source):
    1)   Extract the contents of the tarball into a suitable folder.
    2)   Set up GTK & PyGTK on Windows systems:
    2.1) Download & install the latest (must be >= 2.6) GTK runtime from:
            http://gladewin32.sourceforge.net/
    2.2) Download & install the latest (must be >= 2.6.0) PyGTK version from:
            http://www.pcpm.ucl.ac.be/~gustin/win32_ports/
    3)   Install mysql-python from:
            http://sourceforge.net/project/showfiles.php?group_id=22307
    4)   Install python-twisted (must be >= 1.2, preferably >= 2.0) from:
            http://twistedmatrix.com/


Note: If the fonts look very big in the GUI then try the following gtkrc
      (save the file in, eg. c:\GTK\etc\gtk-2.0\gtkrc):

            style "win32-font"
             {
               font_name = "sans 8"
             }
            class "*" style "win32-font"



================================================
Jajouka is Copyright (c) 2003-2006 Andy Balcombe
     email: jajouka at anti-particle . com
================================================