[elpa] externals/listen 8d030200cd 052/103: Add README

[ELPA Syncer]

branch: externals/listen
commit 8d030200cd071e96d49085da96cf93429b1ab2d0
Author: Adam Porter <adam@alphapapa.net>
Commit: Adam Porter <adam@alphapapa.net>

    Add README
---
 README.org | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.org b/README.org
new file mode 100644
index 0000000000..1c964235f8
--- /dev/null
+++ b/README.org
@@ -0,0 +1,11 @@
+#+title: listen.el
+
+This library aims to provide a simple audio/music player for Emacs.  It should 
"just work," with little-to-no configuration, have intuitive commands, and be 
easily extended and customized.  (Contrast to setting up EMMS, or having to 
configure external players like MPD.)  A ~transient~ menu, under the command 
~listen~, is the primary entry point.
+
+The only external dependency is VLC, which is currently the only player 
backend that is supported.  (Other backends may easily be added; see library 
~listen-vlc~ for example.)  Track metadata is read using EMMS's native Elisp 
metadata library (the only library used from the EMMS package).
+
+Queues are provided as the means to play consecutive tracks, and they are 
shown in a ~vtable~-based view buffer.  They are persisted between sessions 
using the ~persist~ library, and they may be bookmarked.
+
+The primary interface to one's music library is through the filesystem, by 
selecting a file to play, or by adding files and directories to a queue.  
Although MPD is not required, support is provided for finding files from a 
local MPD server's library using MPD's metadata searching.
+
+Note a silly limitation: a track may be present in a queue only once (but who 
would want to have a track more than once in a playlist).