diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/developer-release.txt | 2 | ||||
| -rw-r--r-- | doc/emms.texinfo | 52 |
2 files changed, 43 insertions, 11 deletions
diff --git a/doc/developer-release.txt b/doc/developer-release.txt index be70e22..54930f4 100644 --- a/doc/developer-release.txt +++ b/doc/developer-release.txt @@ -16,6 +16,8 @@ Savannah, as a tarball from GNU, and via GNU ELPA. * Run make upload +* Update copy of emms.info in root directory + * Update online manual * Update website diff --git a/doc/emms.texinfo b/doc/emms.texinfo index 8c83d7c..4e8553f 100644 --- a/doc/emms.texinfo +++ b/doc/emms.texinfo @@ -113,6 +113,7 @@ The Core File Track Information * Using tinytag:: Track information via tinytag. +* Using exiftool:: Track information via exiftool. * Using TagLib:: TagLib for track information. * Defining Info Methods:: Defining new info methods. @@ -883,24 +884,37 @@ pieces of software and libraries which can be used to provide access to track metadata such as the artist's name, track name, album title, etc. -Emms can use tinytag; a small python utility. See @xref{Using -tinytag}. +Emms can use a number of different ways to populate the playlist with +track information. These methods require the installation some +additional software, free software of course, that Emms can then call +to read the metadata from the files. + +@itemize @bullet + +@item +Tinytag, a small python utility. See @xref{Using tinytag}. -Emms can use the TagLib library installed on a system. See @xref{Using -TagLib}. +@item +Exiftool, written in perl. See @xref{Using exiftool}. + +@item +The TagLib library can be used by compiling a small piece of ``shim'' +software. See @xref{Using TagLib}. + +@end itemize -Emms also has multiple predefined methods for retrieving info for -specific file types, provided by modules such as -@file{emms-info-mp3info.el}, @file{emms-info-ogginfo.el}, -@file{emms-info-opusinfo.el}, @file{emms-cue.el} and -@file{emms-info-libtag.el}. The first three packages are front-ends -for command-line tools. Ogg track information is retrieved using the + +You can also use a combination of format-specific tools if needed, +such as @file{emms-info-mp3info.el}, @file{emms-info-ogginfo.el}, +@file{emms-info-opusinfo.el}, and @file{emms-cue.el}. These three +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} and the @uref{https://www.opus-codec.org/ opusinfo} software. Likewise, mp3 track information is available using @uref{http://www.ibiblio.org/mp3info/, mp3info}. @file{emms-cue.el} retrieves tracks information for ape/flac files by parsing a cue sheet -file, which is plain text. +file, which is plain text. Automatic track information retrieval is enabled by default in the `emms-all' setup level provided by @file{emms-setup.el}. For more @@ -931,6 +945,7 @@ track as argument. @menu * Using tinytag:: Track information via tinytag. +* Using exiftool:: Track information via exiftool. * Using TagLib:: TagLib for track information. * Defining Info Methods:: Defining new info methods. @end menu @@ -953,6 +968,21 @@ methods can cause confusion) for Emms: @end lisp +@node Using exiftool +@section Using exiftool + +@cindex Using exiftool + +Make sure that the perl program exiftool is installed on your +system. It is available at @uref{https://exiftool.org/}. + +Then set exiftool as the sole info method with: + +@lisp +(setq emms-info-functions '(emms-info-exiftool)) +@end lisp + + @node Using TagLib @section Using TagLib |