Jajouka README (0.66 "Train") ============== ============== Jajouka is a nice multi-platform GUI interface to a GiantDisc (http://www.giantdisc.org) music collection. ************************************************************************ ** PLEASE READ THE GIANTDISC INFORMATION SECTION BEFORE USING JAJOUKA ** ************************************************************************ Features ======== * rescan / refresh a giantdisc music collection * plays mp3 / ogg music * reads id3v1, id3v2 and ogg music tags * rhythmbox based gui but with a proper playlist Installing =========== See the INSTALL file for more info. Notes & Instructions ==================== * double-click an artist, album or track to add it to the playlist * right-click an album to add to playlist and set an album cover * right-click a track to add to playlist or view the track details using jajouka on windows with a remote giantdisc server ------------------------------------------------------- First, make sure the giantdisc server (GDS) is correctly setup: 1) Ensure Jajouka Server is running on the GDS. 2) Ensure MySQL will allow remote connections: In the /etc/mysql/my.cnf file, comment out the "bind-address=127.0.0.1" entry. 3) Make sure the "GiantDisc User Directory" and "Music Source Directory" settings (under "scanner preferences") should relate to the GDS directories. 4) Make sure GnuMP3d is installed and running on the GDS. Check the "music root" setting in gnump3d.conf points to the giantdisc user home ("/home/music") giantdisc music collection / file structure ------------------------------------------- * I use the following directory structure: tracks -| |-artist-nn1-| | |-album-nn1 | |-album-nn2 | |-... | |-artist-nn2-| | |-album-nn1 | |-album-nn2 | |-... |... giantdisc information --------------------- * jajouka expects that the actual music tracks to be stored in one main location, eg. /home/music/tracks, /mnt/music, etc * when rescanning, jajouka creates links from the main music collection to the giantdisc music directories (ie. [00], [01], [02], ...) * although jajouka can read information from a remotely connected database, it must have read access to the giantdisc home directory (eg. /home/music) in order to play tracks. (eg. mount this as a drive in windows - you'll need to setup samba on the giantdisc server) * when rescanning, jajouka needs read access to the main music collection and read / write access to the giantdisc home directory. * using ssh when rescanning: * ensure either jajouka or jajouka-rescan is installed on the remote PC * to manually refresh the giantdisc database without using the GUI: enter: jajouka-rescan --help or: ./gdisc_rescan.py --help (from the jajouka directory) usage: jajouka-rescan [options] options: --version show program's version number and exit -h, --help show this help message and exit -c, --use-config Use the Jajouka .conf file for configuration -HDB_HOST, --host=DB_HOST GiantDisc database host -uDB_USER, --user=DB_USER GiantDisc database user name -pDB_PASSWORD, --password=DB_PASSWORD GiantDisc database password --gdisc-dir=path Location of giantdisc user directory (default=/home/music) --music-dir=path Location of music tracks directory (eg. /home/music/tracks) --max-tracks=MAX_TRACKS Maximum number of tracks per GiantDisc directory (default 5000) --move-the Move the word 'The' to the end of an Artists Name (eg. Changes "The Cure" to "Cure, The") --clean-db Clear db contents before rescan using jajouka-server -------------------- * the jajouka server can be started using the "jajouka-server-start" command. it should be run under the same user as the giantdisc server itself (eg. "music"). * Make sure GnuMP3d is installed and running. Check the "music root" setting in gnump3d.conf points to the giantdisc user home (eg. "/home/music") Menus ----- giantdisc menu: * refresh giantdisc: refreshes the currently connected giantdisc database the process picks up any new tracks that have been added to the music collection, and creates symlinks for them in the giantdisc [00], [01], [02], ... directories. when tracks with missing artist / album / track title information are found, jajouka will prompt for some input. * empty giantdisc: removes all existing tracks and album records from the giantdisc database and all *symlinks* in the [00], [01], [02], ... directories. edit menu: * edit info: * clear search: clears the search box, and resets all browse information. * preferences: change jajouka preferences. the jajouka.conf file can also be manually edited. playlist menu: * send playlist to player sends the current playlist to an audio player (eg. xmms or winamp) * clear playlist * remove track from playlist removes the currently selected track from the playlist * import giantdisc playlist imports the current giantdisc playlist into jajouka * export playlist to giantdisc exports the current jajouka playlist to giantdisc (this will overwrite the current one) help menu: * about: display jajouka info Configuration ------------- In the jajouka.conf file... [gdisc_db] section: host - the host name for the giantdisc database (eg. localhost) user - the giantdisc database user name (eg. music) passwd - the password for the giantdisc database user (for no password, leave empty) [scanner] section music_dir - the directory *on the giantdisc server* that contains the actual music repository (eg. "/home/music/tracks") gdisc_dir - the directory *on the giantdisc server* that contains the giantdisc installation (almost always "/home/music") move_the_prefix - Move "THE" to the end of an Artists Name (eg. Turning this on would result in "Cure, The" instead of "The Cure") max_tracks - Maximum number of tracks per GiantDisc music directory (eg. 5000) [player] section: binary - location of audio player application (eg. "/usr/bin/xmms" or "C:\Program Files\Quintessential Player\QCDPlayer.exe") enqueue_command - the audio player command to add tracks to the playlist (eg. "--enqueue") play_command - the audio player command to play a playlist (eg. "--play") extra_args - an extra commands for the audio player OS == Jajouka is been developed & tested on Ubuntu "Breezy" 5.10 Credits ======= Thanks to: * The GiantDisc authors (http://www.giantdisc.org) * The Master Musicians of Jajouka (http://www.jajouka.com) * Ned Batchelder for id3reader.py (http://www.nedbatchelder.com/code/modules/id3reader.html) * The Rhythmbox team for providing inspiration and the icons. * The GiantDisc communuity for reporting various bugs and problems with the make scripts. Comments ======== Any problems, suggestions, features, patches or comments please contact me at the address below... ================================================ Jajouka is Copyright (c) 2003-2006 Andy Balcombe email: jajouka at anti-particle . com ================================================