1 Description:

2

3 cplay is a curses front-end for various audio players. It aims

4 to provide a power-user-friendly interface with simple filelist

5 and playlist control. cplay is written in Python and can use

6 either pyncurses or the standard curses module.

7

8 Requirements:

9

10 - cplay http://www.tf.hut.fi/~flu/cplay/

11 - python http://www.python.org/

12 - python-oss (optional) http://net.indra.com/~tim/ossmodule/

13 - mpg321 (optional) http://sourceforge.net/projects/mpg321/

14 - ogg123 (optional) http://www.vorbis.com/

15 - mpg123 (optional) http://www.mpg123.org/

16 - splay (optional) http://splay.sourceforge.net/

17 - madplay (optional) http://www.mars.org/home/rob/proj/mpeg/

18 - mikmod (optional) http://www.mikmod.org/

19 - fintl (optional) http://www.python.org/sigs/i18n-sig/

20 - pyncurses (optional) http://pyncurses.sourceforge.net/

21 - ID3-py (optional) http://id3-py.sourceforge.net/

22 - pyvorbis (optional) http://www.duke.edu/~ahc4/pyogg/

23 - xmp (optional) http://xmp.sf.net/

24 - sox (optional) http://sox.sf.net/

25 - speex (optional) http://www.speex.org/

26

27 Installation:

28

29 make install

30

31 Usage:

32

33 cplay [-nrRv] [ file | dir | playlist ] ...

34

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

36

37 Configuration:

38

39 If you would like to change options passed to the actual players

40 just edit the PLAYERS list in the cplay script or put the PLAYERS

41 definition in either ~/.cplayrc or /etc/cplayrc. If one of these

42 files is available, it is executed by cplay before initialization.

43

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

45

46 Miscellaneous:

47

48 In order for either mp3info (ID3) or ogginfo to work,

49 both corresponding python modules have to be installed.

50 This will probably change someday.

51

52 A playlist can contain URLs, but the playlist itself will

53 have to be local. For mpeg streaming, splay is recommended.

54

55 It is also possible to pipe a playlist to cplay, as stdin

56 will be reopened on startup unless it is attached to a tty.

57

58 Remote control via /var/tmp/cplay_control; see lircrc.

59