Description:

        cplay is a curses front-end for various audio players. It aims
        to provide a power-user-friendly interface with simple filelist
        and playlist control. cplay is written in Python and can use
        either pyncurses or the standard curses module.

Requirements:

    - cplay                   http:https://www.tf.hut.fi/~flu/cplay/
    - python                  http:https://www.python.org/
    - pyncurses               http:https://pyncurses.sourceforge.net/
    - pyalsaaudio (optional)  http:https://pyalsaaudio.sourceforge.net/
                                For Alsa mixer support
    - python-oss  (optional)  http:https://net.indra.com/~tim/ossmodule/
                                For OSS mixer support
    - mutagen     (optional)  http:https://code.google.com/p/mutagen/
                                For metadata support (IDv3 etc.)
    - magic       (optional)  http:https://www.darwinsys.com/file/
                                For better filetype recognition

For playback either install mplayer (recommended): http:https://www.mplayerhq.hu/
or one or more of the following players:

    - mpg321                  http:https://sourceforge.net/projects/mpg321/
    - ogg123                  http:https://www.vorbis.com/
    - mpg123                  http:https://www.mpg123.org/
    - splay                   http:https://splay.sourceforge.net/
    - madplay                 http:https://www.mars.org/home/rob/proj/mpeg/
    - mikmod                  http:https://www.mikmod.org/
    - xmp                     http:https://xmp.sf.net/
    - sox                     http:https://sox.sf.net/
    - speex                   http:https://www.speex.org/

Installation:

        make install

Usage:

        cplay [-dFileForDebugOutput] [-mnrR] [ file | dir | playlist ] ...

        When in doubt, press 'h' for a friendly help page.

Configuration:

        If you would like to change options passed to the actual players
        just edit the PLAYERS list in the cplay script or put the PLAYERS
        definition in either ~/.cplayrc or /etc/cplayrc. If one of these
        files is available, it is executed by cplay before initialization.

        Macros are defined using the MACRO dictionary, where the key is
        a key and the value is a string of cplay input. For example, the
        following would make ,d delete tagged (or current) files:

                MACRO['d'] = '!rm "$@"\n'

        Note, there is currently no version control for the rc-file!

Miscellaneous:

        A playlist can contain URLs, but the playlist itself will
        have to be local. For mpeg streaming, splay is recommended.

        It is also possible to pipe a playlist to cplay, as stdin
        will be reopened on startup unless it is attached to a tty.

        Remote control is available via /var/tmp/cplay_control-$USER.
        Create this with mkfifo and see lircrc for examples.

        The shell command gets the full path of either all tagged
        items or the current item as positional arguments.