From 1d9768214922915e21b3304587d8f4b41ce22faa Mon Sep 17 00:00:00 2001 From: "Adrian C. (anrxc)" Date: Wed, 20 Oct 2010 03:45:48 +0200 Subject: README: added basic project information --- README | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 README diff --git a/README b/README new file mode 100644 index 0000000..b0d29ec --- /dev/null +++ b/README @@ -0,0 +1,35 @@ +Description: + + play is a curses front-end for various audio players, based on + cplay. It aims to provide a power-user-friendly interface with + simple filelist and playlist control. play is written in + Python and can use either pyncurses or the standard curses + module. + +Usage: + + play [-nrRv] [ file | dir | playlist | url ] ... + + When in doubt, press 'h' for a friendly help page. + +Miscellaneous: + + In order for either mp3info (ID3) or ogginfo to work, both + corresponding python modules have to be installed. However, + quick support for MP3 tags can be added by getting 'ID3.py' + from the id3-py project: http://id3-py.sourceforge.net/ + + A playlist can contain URLs, but the playlist itself will have + to be local. For mpeg streaming, splay is recommended. + + It is also possible to pipe a playlist to play, as stdin will + be reopened on startup unless it is attached to a tty. + + Remote control is available through /tmp/play-control-$USER. + +Authors: + + play is being maintained by Adrian C. After waiting over 2 + years for cplay's home, and code, to resurface it was finally + forked. This exceptional software, originally written by Ulf + Betlehem, should not be forgotten. -- cgit v1.2.3