The following is an abbreviated list of commands to get you started.
Begin HighPriest with
> hp run
. If hp cannot be found, you need to configure your
$PATH, or specify the entire path to hp, which is in
your HighPriest/bin folder.
Running HighPriest the first time may take a while before playing since it needs to read all of the playlist files. Future executions will start up much more quickly.
> hp list
will display a numbered list of the catalogued playlists. You may also abbreviate this command as
> hp l
. Each line begins with the number and the nickname of a playlist. You may refer to a playlist with either. To list the tracks of a playlist, use
> hp l <#>
or
> hp l <nickname>
. The nickname is generated automatically when you use
gen-playlist to create the playlist initially. You may change the
nickname to something else by simply editing the XML playlist file directly.
To add a playlist to the queue,
> hp add <playlist>
where <playlist> may be either its number or nickname. To
add a particular track,
> hp add <playlist> <track #>
. You may also add a range of tracks. For example,
> hp add 35 2-5,9,11
would add tracks 2, 3, 4, 5, 9, and 11 of playlist 35 to the queue.
To list the queue, use
> hp queue
or
> hp q
for short.
If you add, modify, or delete your playlists, the changes are not automatically registered by the HighPriest daemon. To notify it of playlist updates, issue the following:
> hp update
or
> hp up
for short. Only playlists changed since the last update will be examined. It may be necessary at times to force an update of all playlists. Use
> hp up force
to do this.
To get a full list of commands for the HighPriest daemon, invoke
> hp help
.
I find it convenient to run two terminal windows, as shown in this screenshot >>.
In the first one I issue the `hp run` command, so this window
will display the 'Cueing...' messages indicating the upcoming tracks. (Note:
the VERBOSE variable in HighPriest.conf must be
nonzero in order to receive these message.) I issue all other commands in the
second, larger window. The larger size is helpful for large music listings.