Juke - A Juke Box
=================

1 Introduction

Juke is a curses/ ncurses based juke box program for Unix computers.
The program uses command line base player to play all kinds of different
music files.

2 Configuration

Juke uses a configuration file called juke.conf to specifiy which program
is to be associated with a certain file format. Here is a sample file.

# Sample juke configuration file
# @ is replaced by juke with the file to play

.mp3   mpg123 -b 128 -q @
.xm    mikmod -o -n -q @
.mod   mikmod -o -n -q @
.psg   psgplay -q @

I hope that the format is kind of self explaining.

The configuration file can be saved as /etc/juke.conf or
~/.juke.conf. The later is used if both files exists.

3 Usage

Juke is started with one or more directories as parameters.  The
directories are scanned for files specified in the configuration
file.

Juke have two modes of operation. The items mode that is a directory
tree listning and the queue mode that is the tunes that are scheduled
for playing.

Here are the keys used.

a          Add item to queue
b          Page up
c          Clear queue
d          Delete item from queue
h          Help message
i, up      Move cursor up
j, left    Enter directory at cursor position
k, down    Move cursor down
l, right   Leave current directory
m          Move item to top of queue
p          Pause player
q          Quit
r          Randomize items in queue
s          Skip playing item
t          Toggle display mode
space      Page down

Well thats it. The latest version should always be available at
http://www.nocrew.org/software/juke.
