cplay

annotate README @ 2:c7d8ec7da73b

Add mplayer as a backend player Plus: exchange PCM and Master mixer.
author markus schnalke <meillo@marmaro.de>
date Thu, 27 Jul 2017 07:08:00 +0200
parents
children
rev   line source
meillo@0 1 Description:
meillo@0 2
meillo@0 3 cplay is a curses front-end for various audio players. It aims
meillo@0 4 to provide a power-user-friendly interface with simple filelist
meillo@0 5 and playlist control. cplay is written in Python and can use
meillo@0 6 either pyncurses or the standard curses module.
meillo@0 7
meillo@0 8 Requirements:
meillo@0 9
meillo@0 10 - cplay http://www.tf.hut.fi/~flu/cplay/
meillo@0 11 - python http://www.python.org/
meillo@0 12 - python-oss (optional) http://net.indra.com/~tim/ossmodule/
meillo@0 13 - mpg321 (optional) http://sourceforge.net/projects/mpg321/
meillo@0 14 - ogg123 (optional) http://www.vorbis.com/
meillo@0 15 - mpg123 (optional) http://www.mpg123.org/
meillo@0 16 - splay (optional) http://splay.sourceforge.net/
meillo@0 17 - madplay (optional) http://www.mars.org/home/rob/proj/mpeg/
meillo@0 18 - mikmod (optional) http://www.mikmod.org/
meillo@0 19 - fintl (optional) http://www.python.org/sigs/i18n-sig/
meillo@0 20 - pyncurses (optional) http://pyncurses.sourceforge.net/
meillo@0 21 - ID3-py (optional) http://id3-py.sourceforge.net/
meillo@0 22 - pyvorbis (optional) http://www.duke.edu/~ahc4/pyogg/
meillo@0 23 - xmp (optional) http://xmp.sf.net/
meillo@0 24 - sox (optional) http://sox.sf.net/
meillo@0 25 - speex (optional) http://www.speex.org/
meillo@0 26
meillo@0 27 Installation:
meillo@0 28
meillo@0 29 make install
meillo@0 30
meillo@0 31 Usage:
meillo@0 32
meillo@0 33 cplay [-nrRv] [ file | dir | playlist ] ...
meillo@0 34
meillo@0 35 When in doubt, press 'h' for a friendly help page.
meillo@0 36
meillo@0 37 Configuration:
meillo@0 38
meillo@0 39 If you would like to change options passed to the actual players
meillo@0 40 just edit the PLAYERS list in the cplay script or put the PLAYERS
meillo@0 41 definition in either ~/.cplayrc or /etc/cplayrc. If one of these
meillo@0 42 files is available, it is executed by cplay before initialization.
meillo@0 43
meillo@0 44 Note, currently there is no version control for the rc-file!
meillo@0 45
meillo@0 46 Miscellaneous:
meillo@0 47
meillo@0 48 In order for either mp3info (ID3) or ogginfo to work,
meillo@0 49 both corresponding python modules have to be installed.
meillo@0 50 This will probably change someday.
meillo@0 51
meillo@0 52 A playlist can contain URLs, but the playlist itself will
meillo@0 53 have to be local. For mpeg streaming, splay is recommended.
meillo@0 54
meillo@0 55 It is also possible to pipe a playlist to cplay, as stdin
meillo@0 56 will be reopened on startup unless it is attached to a tty.
meillo@0 57
meillo@0 58 Remote control via /var/tmp/cplay_control; see lircrc.
meillo@0 59