diff options
author | William Xu <william.xwl@gmail.com> | 2010-03-19 23:35:59 +0800 |
---|---|---|
committer | William Xu <william.xwl@gmail.com> | 2010-03-19 23:35:59 +0800 |
commit | 4dcb06d6597890337c04b08a88b0fc553cc558e6 (patch) | |
tree | 4900745762c45a43e09c416e515ca585207f628c | |
parent | 9390fc321a233787dcb2dfc9426f7468c32153bc (diff) |
Move emms-cue.el from emms-devel to emms-all and update manual.
-rw-r--r-- | doc/emms.texinfo | 34 | ||||
-rw-r--r-- | lisp/emms-setup.el | 10 |
2 files changed, 35 insertions, 9 deletions
diff --git a/doc/emms.texinfo b/doc/emms.texinfo index 0f44add..1fca86c 100644 --- a/doc/emms.texinfo +++ b/doc/emms.texinfo @@ -82,6 +82,7 @@ Modules and Extensions * Lyrics:: Displaying lyrics synchronously. * Volume:: Changing the volume. * Last.fm:: Interact with http://www.last.fm's services. +* APE / FLAC Commands:: How to play next or previous track in these files. * Extending Emms:: How to define new players and modules. Copying and license @@ -860,13 +861,15 @@ The current Emms playlist buffer is stored in the variable @cindex track information @cindex info tags -Emms is distributed with two predefined methods for retrieving info, -provided by @file{emms-info-mp3info.el} and -@file{emms-info-ogginfo.el}. Both packages are front-ends for +Emms is distributed with three predefined methods for retrieving info, +provided by @file{emms-info-mp3info.el}, @file{emms-info-ogginfo.el} and +@file{emms-cue.el}. The first two packages are front-ends for command-line tools. Ogg track information is retrieved using the @uref{http://directory.fsf.org/audio/ogg/vorbistools.html, ogginfo} software. Likewise, mp3 track information is available using -@uref{http://www.ibiblio.org/mp3info/, mp3info}. +@uref{http://www.ibiblio.org/mp3info/, mp3info}. While, +@file{emms-cue.el} retrieves tracks information for ape/flac files by +parsing a cue sheet file, which is plain text. Automatic track information retrieval is enabled by default in the `emms-standard', `emms-all' and `emms-devel' setup levels provided by @@ -1129,6 +1132,29 @@ except it collects result of given function (that's why named with `mapcar'). @end defun +@node APE / FLAC Commands +@chapter APE / FLAC Commands + +Often, a single APE or FLAC file contains a complete ablum. We can still +play next or previous track in the ablum with the help of +@file{emms-cue.el} package, provided there is a corresponding cue sheet +file. This package also defines @code{emms-info-cueinfo} for retreiving +the track information for APE / FLAC itself. + +To load @file{emms-cue.el}: + +@lisp +(require 'emms-cue) +(add-to-list 'emms-info-functions 'emms-info-cueinfo) +@end lisp + +@defun emms-cue-next +Play next track from .cue file +@end defun +@defun emms-cue-previous +Play previous track from .cue file +@end defun + @node Extending Emms @chapter Extending Emms diff --git a/lisp/emms-setup.el b/lisp/emms-setup.el index 15f8cb7..04cf404 100644 --- a/lisp/emms-setup.el +++ b/lisp/emms-setup.el @@ -109,12 +109,14 @@ stable features which come with the Emms distribution." (require 'emms-player-xine) (require 'emms-playlist-sort) (require 'emms-browser) - (require 'emms-mode-line-icon)) + (require 'emms-mode-line-icon) + (require 'emms-cue)) ;; setup (emms-mode-line 1) (emms-mode-line-blank) (emms-lyrics 1) - (emms-playing-time 1)) + (emms-playing-time 1) + (add-to-list 'emms-info-functions 'emms-info-cueinfo)) ;;;###autoload (defun emms-devel () @@ -138,13 +140,11 @@ on the edge." (require 'emms-tag-editor) (require 'emms-volume) (require 'emms-playlist-limit) - (require 'emms-cue) (require 'emms-lastfm-client)) ;; setup (add-hook 'emms-player-started-hook 'emms-last-played-update-current) (emms-score 1) - (emms-playlist-limit 1) - (add-to-list 'emms-info-functions 'emms-info-cueinfo)) + (emms-playlist-limit 1)) ;;;###autoload (defun emms-default-players () |