cplay
annotate README @ 0:aa5f022eac8a
Use upstream cplay-1.49 as a start
| author | markus schnalke <meillo@marmaro.de> |
|---|---|
| date | Wed, 27 Sep 2017 09:22:32 +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 |