Mercurial > cplay

annotate README @ 0:aa5f022eac8a 1.49

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