From 53944e11a9ac6acb92d53157315530757a4b3ae7 Mon Sep 17 00:00:00 2001 From: Yoni Rabkin Date: Thu, 24 Sep 2020 21:04:06 -0400 Subject: * doc/emms.texinfo: update manual regarding exiftool --- emms.info | 168 +++++++++++++++++++++++++++++++++++--------------------------- 1 file changed, 95 insertions(+), 73 deletions(-) (limited to 'emms.info') diff --git a/emms.info b/emms.info index 5b27632..222b731 100644 --- a/emms.info +++ b/emms.info @@ -97,6 +97,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. @@ -739,20 +740,25 @@ is distributed with support for a number of 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 *Note 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. - Emms can use the TagLib library installed on a system. See *Note -Using TagLib::. + * Tinytag, a small python utility. See *Note Using tinytag::. - Emms also has multiple predefined methods for retrieving info for -specific file types, provided by modules such as 'emms-info-mp3info.el', -'emms-info-ogginfo.el', 'emms-info-opusinfo.el', 'emms-cue.el' and -'emms-info-libtag.el'. The first three packages are front-ends for -command-line tools. Ogg track information is retrieved using the -ogginfo (http://directory.fsf.org/audio/ogg/vorbistools.html) and the - software. Likewise, mp3 track -information is available using mp3info + * Exiftool, written in perl. See *Note Using exiftool::. + + * The TagLib library can be used by compiling a small piece of "shim" + software. See *Note Using TagLib::. + + You can also use a combination of format-specific tools if needed, +such as 'emms-info-mp3info.el', 'emms-info-ogginfo.el', +'emms-info-opusinfo.el', and 'emms-cue.el'. These three packages are +front-ends for command-line tools. Ogg track information is retrieved +using the ogginfo (http://directory.fsf.org/audio/ogg/vorbistools.html) +and the software. Likewise, mp3 +track information is available using mp3info (http://www.ibiblio.org/mp3info/). 'emms-cue.el' retrieves tracks information for ape/flac files by parsing a cue sheet file, which is plain text. @@ -784,11 +790,12 @@ Methods::. * 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.  -File: emms.info, Node: Using tinytag, Next: Using TagLib, Up: Track Information +File: emms.info, Node: Using tinytag, Next: Using exiftool, Up: Track Information 13.1 Using tinytag ================== @@ -802,9 +809,22 @@ methods can cause confusion) for Emms: (setq emms-info-functions '(emms-info-tinytag))  -File: emms.info, Node: Using TagLib, Next: Defining Info Methods, Prev: Using tinytag, Up: Track Information +File: emms.info, Node: Using exiftool, Next: Using TagLib, Prev: Using tinytag, Up: Track Information + +13.2 Using exiftool +=================== + +Make sure that the perl program exiftool is installed on your system. +It is available at . + + Then set exiftool as the sole info method with: + + (setq emms-info-functions '(emms-info-exiftool)) + + +File: emms.info, Node: Using TagLib, Next: Defining Info Methods, Prev: Using exiftool, Up: Track Information -13.2 Using TagLib +13.3 Using TagLib ================= 'emms-info-libtag.el' uses a tiny C shim (included in the src/ @@ -836,7 +856,7 @@ TagLib data):  File: emms.info, Node: Defining Info Methods, Prev: Using TagLib, Up: Track Information -13.3 Defining Info Methods +13.4 Defining Info Methods ========================== An info method essentially consists of a function which given an Emms @@ -3398,6 +3418,7 @@ Concept Index * track information: Track Information. (line 6) * track order: Sorting Playlists. (line 6) * user variables: User Variables. (line 6) +* Using exiftool: Using exiftool. (line 6) * using taglib: Using TagLib. (line 6) * Using tinytag: Using tinytag. (line 6) * volume: Volume. (line 6) @@ -3640,9 +3661,9 @@ Variable Index * emms-history-file: Persistent Playlists. (line 14) * emms-history-start-playing: Persistent Playlists. (line 33) -* emms-info-asynchronously: Track Information. (line 45) -* emms-info-auto-update: Track Information. (line 41) -* emms-info-functions: Track Information. (line 50) +* emms-info-asynchronously: Track Information. (line 50) +* emms-info-auto-update: Track Information. (line 46) +* emms-info-functions: Track Information. (line 55) * emms-lyrics-coding-system: Lyrics. (line 36) * emms-lyrics-dir: Lyrics. (line 27) * emms-lyrics-display-format: Lyrics. (line 32) @@ -3732,59 +3753,60 @@ Keybinding Index  Tag Table: Node: Top689 -Node: Introduction4369 -Node: Quickstart Guide5944 -Node: Installation8694 -Node: Compiling Emms9107 -Node: Setup9795 -Node: Configuration10781 -Node: Finding files and speed12192 -Node: Getting Help13038 -Node: Formats and Freedom13616 -Node: Basic Commands14821 -Node: The Core File18202 -Node: User Variables18636 -Node: Hooks19612 -Node: Core Functions21038 -Node: Sources24038 -Node: Simple Players26171 -Node: Playlists27265 -Node: Track Information28546 -Node: Using tinytag31112 -Node: Using TagLib31539 -Node: Defining Info Methods32647 -Node: Interactive Playlists33429 -Node: Markable Playlists36471 -Node: Extending Emms38942 -Node: New Player39378 -Node: Simple Player for `play'39767 -Node: More Complex Player41495 -Node: The Browser44502 -Node: Browser Interface45478 -Node: Filtering Tracks47892 -Node: Displaying Covers49670 -Node: Changing Looks51684 -Node: Sorting Playlists54662 -Node: Persistent Playlists56131 -Node: Editing Tracks57290 -Node: Emms Mode Line60964 -Node: Limiting62132 -Node: Music Player Daemon64471 -Node: Lyrics67984 -Node: Volume70032 -Node: Streaming Audio71820 -Ref: Streaming Audio-Footnote-172412 -Node: APE / FLAC Commands72763 -Node: Bookmarks73470 -Node: Managing Playlists74181 -Node: GNU FM75204 -Node: Uploading Track Information76558 -Node: GNU FM Streaming77440 -Node: Copying77940 -Node: The GNU FDL115457 -Node: Concept Index137845 -Node: Function Index142703 -Node: Variable Index158395 -Node: Keybinding Index160738 +Node: Introduction4430 +Node: Quickstart Guide6005 +Node: Installation8755 +Node: Compiling Emms9168 +Node: Setup9856 +Node: Configuration10842 +Node: Finding files and speed12253 +Node: Getting Help13099 +Node: Formats and Freedom13677 +Node: Basic Commands14882 +Node: The Core File18263 +Node: User Variables18697 +Node: Hooks19673 +Node: Core Functions21099 +Node: Sources24099 +Node: Simple Players26232 +Node: Playlists27326 +Node: Track Information28607 +Node: Using tinytag31494 +Node: Using exiftool31923 +Node: Using TagLib32295 +Node: Defining Info Methods33404 +Node: Interactive Playlists34186 +Node: Markable Playlists37228 +Node: Extending Emms39699 +Node: New Player40135 +Node: Simple Player for `play'40524 +Node: More Complex Player42252 +Node: The Browser45259 +Node: Browser Interface46235 +Node: Filtering Tracks48649 +Node: Displaying Covers50427 +Node: Changing Looks52441 +Node: Sorting Playlists55419 +Node: Persistent Playlists56888 +Node: Editing Tracks58047 +Node: Emms Mode Line61721 +Node: Limiting62889 +Node: Music Player Daemon65228 +Node: Lyrics68741 +Node: Volume70789 +Node: Streaming Audio72577 +Ref: Streaming Audio-Footnote-173169 +Node: APE / FLAC Commands73520 +Node: Bookmarks74227 +Node: Managing Playlists74938 +Node: GNU FM75961 +Node: Uploading Track Information77315 +Node: GNU FM Streaming78197 +Node: Copying78697 +Node: The GNU FDL116214 +Node: Concept Index138602 +Node: Function Index143533 +Node: Variable Index159225 +Node: Keybinding Index161568  End Tag Table -- cgit v1.2.3