HighPriest depends on the following software, so install them first.
XMMS is the X MultiMedia System >>. Install this if you don't already have it.
Once installed, go into Preferences | Options and set 'Allow multiple instances'.
This is a nice plugin for XMMS which mixes the output of multiple XMMS clients. Go to the Plugins section of XMMS.org >> and do a search on 'DBMix'.
You need Perl 5 >>.
You also need the following Perl modules, available from CPAN >>:
Math::Random
XMMS
XMMS::Remote
MP3::Tag
Simply unzip the downloaded file to a directory of your choice, say
/usr/local/apps or ~/apps. This will create a
HighPriest subdirectory. Then add the following to your shell
startup file (eg, .bashrc or .zshrc in your home
directory):
export PATH=$PATH:<...>/HighPriest/bin
where <...> should be replaced by the folder you
unzipped the download file. Next
configure your installation \/, and finally
generate default playlists \/.
In the HighPriest/etc directory is a default
HighPriest.conf file containing configuration options for
HighPriest. You may either modify this file, or copy it to one
of the following locations:
/etc/HighPriest/HighPriest.conf
~/.HighPriest/HighPriest.conf
~/Choices/HighPriest/HighPriest.conf
The most important options to configure first are MUSIC_DIRS,
MUSIC_FILE_EXTS, PLAYLIST_ROOT, and
STATE_DIR.
MUSIC_DIRS |
Directory containing your music files. For example
~/MP3s. If you have more than one, separate them with
commas.
|
MUSIC_FILE_EXTS |
File extensions which indicate music files, eg mp3. If you
have more than one, separate them with commas.
|
PLAYLIST_ROOT |
Folder to contain your XML playlist files, eg
~/HighPriest.playlists.
|
STATE_DIR |
Folder to contain HighPriest state information, eg
~/.HighPriest.
|
Lastly, you need to generate default playlist files before you can start HighPriest.
This last step is to catalog all of your music files you intend to add to the HighPriest jukebox.
If it doesn't already exist, create the directory you specified as
PLAYLIST_ROOT above. To add all music files in a given directory
(including all subdirectories), issue the command:
> gen-playlist -R <music-dir>
Note: The HighPriest/bin directory must be in your
$PATH for this to work. Otherwise, specify the whole path to
gen-playlist. The -R flag indicates a recursive
search through all subdirectories of <music-dir>. If you
want to catalog the music files for only one directory, leave off the
-R flag.
As you add more music folders, you may use gen-playlist to
create a new XML playlist file for each new folder:
> gen-playlist <music-dir>
You should be ready to start using HighPriest. Check the
PLAYLIST_ROOT to see that the playlist files were created, then
check out
Usage Notes >>.