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
|