meillo@0: Description:
meillo@0: 
meillo@0:         cplay is a curses front-end for various audio players. It aims
meillo@0:         to provide a power-user-friendly interface with simple filelist
meillo@0:         and playlist control. cplay is written in Python and can use
meillo@0:         either pyncurses or the standard curses module.
meillo@0: 
meillo@0: Requirements:
meillo@0: 
meillo@0:         - cplay                   http://www.tf.hut.fi/~flu/cplay/
meillo@0:         - python                  http://www.python.org/
meillo@0:         - python-oss  (optional)  http://net.indra.com/~tim/ossmodule/
meillo@0:         - mpg321      (optional)  http://sourceforge.net/projects/mpg321/
meillo@0:         - ogg123      (optional)  http://www.vorbis.com/
meillo@0:         - mpg123      (optional)  http://www.mpg123.org/
meillo@0:         - splay       (optional)  http://splay.sourceforge.net/
meillo@0:         - madplay     (optional)  http://www.mars.org/home/rob/proj/mpeg/
meillo@0:         - mikmod      (optional)  http://www.mikmod.org/
meillo@0:         - fintl       (optional)  http://www.python.org/sigs/i18n-sig/
meillo@0:         - pyncurses   (optional)  http://pyncurses.sourceforge.net/
meillo@0:         - ID3-py      (optional)  http://id3-py.sourceforge.net/
meillo@0:         - pyvorbis    (optional)  http://www.duke.edu/~ahc4/pyogg/
meillo@0:         - xmp         (optional)  http://xmp.sf.net/
meillo@0:         - sox         (optional)  http://sox.sf.net/
meillo@0:         - speex       (optional)  http://www.speex.org/
meillo@0: 
meillo@0: Installation:
meillo@0: 
meillo@0:         make install
meillo@0: 
meillo@0: Usage:
meillo@0: 
meillo@0:         cplay [-nrRv] [ file | dir | playlist ] ...
meillo@0: 
meillo@0:         When in doubt, press 'h' for a friendly help page.
meillo@0: 
meillo@0: Configuration:
meillo@0: 
meillo@0:         If you would like to change options passed to the actual players
meillo@0:         just edit the PLAYERS list in the cplay script or put the PLAYERS
meillo@0:         definition in either ~/.cplayrc or /etc/cplayrc. If one of these
meillo@0:         files is available, it is executed by cplay before initialization.
meillo@0: 
meillo@0:         Note, currently there is no version control for the rc-file!
meillo@0: 
meillo@0: Miscellaneous:
meillo@0: 
meillo@0:         In order for either mp3info (ID3) or ogginfo to work,
meillo@0:         both corresponding python modules have to be installed.
meillo@0:         This will probably change someday.
meillo@0: 
meillo@0:         A playlist can contain URLs, but the playlist itself will
meillo@0:         have to be local. For mpeg streaming, splay is recommended.
meillo@0: 
meillo@0:         It is also possible to pipe a playlist to cplay, as stdin
meillo@0:         will be reopened on startup unless it is attached to a tty.
meillo@0: 
meillo@0:         Remote control via /var/tmp/cplay_control; see lircrc.
meillo@0: