From 779f563d6b381bcac6ef81cf1d3eb928379dd4f7 Mon Sep 17 00:00:00 2001 From: Yoni Rabkin Date: Sat, 27 Mar 2021 14:32:50 -0400 Subject: * emms.info: update --- emms.info | 178 ++++++++++++++++++++++++++++++++------------------------------ 1 file changed, 93 insertions(+), 85 deletions(-) diff --git a/emms.info b/emms.info index 4c46802..32238b4 100644 --- a/emms.info +++ b/emms.info @@ -195,8 +195,8 @@ restart Emacs to let the changes have an effect. Now we will add all our music to a playlist by invoking 'M-x emms-add-directory-tree RET ~/Music/ RET'. We do this because then Emms -will read the tags of all your music files and caches them (this is also -required for the Emms browser, *Note The Browser::.) +will read the tags of all your music files and caches them (the cache is +also required for the Emms browser, *Note The Browser::.) To switch to the playlist buffer, invoke 'M-x emms-playlist-mode-go' or simply 'M-x emms'. You may see that some tracks are displayed with @@ -798,12 +798,18 @@ chapter. Fundamentally, info methods are Emacs Lisp functions that are called for each track to provide information for that track. Current info methods in Emms are restricted to tracks that are files; they do not -work with stream URLs (*note Streaming Audio::). Most of the methods +work with stream URLs (*note Streaming Audio::). Some of the methods require installation of some additional software that Emms can then call to read metadata from disk (*note Metadata Utilities::). Finally, some methods work only with a limited set of media file formats such as Ogg or MP3, while some methods support a wide variety of formats. + If caching is enabled (it is by default) then the metadata for each +track will be stored in the cache for faster retrieval. That means if +you change info method and want updated tracks, you will have to reset +the cache 'M-x emms-cache-reset' and then repopulate with 'M-x +emms-add-directory-tree RET ~/Music/ RET' or similar. + Automatic track information retrieval is enabled by default in the 'emms-all' setup level (*note Setup::). That setup level configures Emms to use 'emms-info-native' and 'emms-info-cueinfo' methods, as they @@ -3891,36 +3897,38 @@ Variable Index [index] * Menu: -* emms-history-file: Persistent Playlists. (line 14) -* emms-history-start-playing: Persistent Playlists. (line 33) -* emms-info-asynchronously: Track Information. (line 93) -* emms-info-auto-update: Track Information. (line 88) -* emms-info-functions: Track Information. (line 99) -* emms-lyrics-coding-system: Lyrics. (line 36) -* emms-lyrics-dir: Lyrics. (line 27) -* emms-lyrics-display-format: Lyrics. (line 32) -* emms-lyrics-display-on-minibuffer: Lyrics. (line 21) -* emms-lyrics-display-on-modeline: Lyrics. (line 24) -* emms-lyrics-scroll-p: Lyrics. (line 39) -* emms-lyrics-scroll-timer-interval: Lyrics. (line 42) -* emms-player-finished-hook: Hooks. (line 23) -* emms-player-list: User Variables. (line 8) -* emms-player-paused-hook: Hooks. (line 29) -* emms-player-started-hook: Hooks. (line 9) -* emms-player-stopped-hook: Hooks. (line 11) -* emms-playlist-cleared-hook: Hooks. (line 19) -* emms-playlist-selection-changed-hook: Hooks. (line 17) -* emms-playlist-source-inserted-hook: Hooks. (line 14) -* emms-repeat-playlist: User Variables. (line 15) -* emms-show-format: User Variables. (line 11) -* emms-sort-lessp-function: User Variables. (line 21) -* emms-source-file-default-directory: Sources. (line 13) -* emms-tag-editor-formats: Editing Tracks. (line 55) -* emms-tag-editor-rename-format: Editing Tracks. (line 73) -* emms-tag-editor-tagfile-functions: Editing Tracks. (line 63) -* emms-track-description-function: User Variables. (line 19) -* emms-volume-change-amount: Volume. (line 9) -* emms-volume-mode-timeout: Volume. (line 42) +* emms-history-file: Persistent Playlists. + (line 14) +* emms-history-start-playing: Persistent Playlists. + (line 33) +* emms-info-asynchronously: Track Information. (line 99) +* emms-info-auto-update: Track Information. (line 94) +* emms-info-functions: Track Information. (line 105) +* emms-lyrics-coding-system: Lyrics. (line 36) +* emms-lyrics-dir: Lyrics. (line 27) +* emms-lyrics-display-format: Lyrics. (line 32) +* emms-lyrics-display-on-minibuffer: Lyrics. (line 21) +* emms-lyrics-display-on-modeline: Lyrics. (line 24) +* emms-lyrics-scroll-p: Lyrics. (line 39) +* emms-lyrics-scroll-timer-interval: Lyrics. (line 42) +* emms-player-finished-hook: Hooks. (line 23) +* emms-player-list: User Variables. (line 8) +* emms-player-paused-hook: Hooks. (line 29) +* emms-player-started-hook: Hooks. (line 9) +* emms-player-stopped-hook: Hooks. (line 11) +* emms-playlist-cleared-hook: Hooks. (line 19) +* emms-playlist-selection-changed-hook: Hooks. (line 17) +* emms-playlist-source-inserted-hook: Hooks. (line 14) +* emms-repeat-playlist: User Variables. (line 15) +* emms-show-format: User Variables. (line 11) +* emms-sort-lessp-function: User Variables. (line 21) +* emms-source-file-default-directory: Sources. (line 13) +* emms-tag-editor-formats: Editing Tracks. (line 55) +* emms-tag-editor-rename-format: Editing Tracks. (line 73) +* emms-tag-editor-tagfile-functions: Editing Tracks. (line 63) +* emms-track-description-function: User Variables. (line 19) +* emms-volume-change-amount: Volume. (line 9) +* emms-volume-mode-timeout: Volume. (line 42)  File: emms.info, Node: Keybinding Index, Prev: Variable Index, Up: Top @@ -3987,57 +3995,57 @@ Tag Table: Node: Top701 Node: Introduction4336 Node: Quickstart Guide5804 -Node: Installation8672 -Node: Compiling Emms9221 -Node: Setup9909 -Node: Configuration10895 -Node: Finding files and speed12370 -Node: Setup Examples13239 -Node: Getting Help15172 -Node: Formats and Freedom15750 -Node: Basic Commands16955 -Node: The Core File20336 -Node: User Variables20770 -Node: Hooks21746 -Node: Core Functions23172 -Node: Sources26172 -Node: Simple Players28305 -Node: Playlists29362 -Node: Track Information30643 -Node: Metadata Utilities35022 -Node: Defining Info Methods39694 -Node: Interactive Playlists41838 -Node: Markable Playlists44880 -Node: Extending Emms47351 -Node: New Player47787 -Node: Simple Player for `play'48176 -Node: More Complex Player49904 -Node: The Browser52911 -Node: Browser Interface53887 -Node: Filtering Tracks56301 -Node: Displaying Covers58079 -Node: Changing Looks60093 -Node: Sorting Playlists63071 -Node: Persistent Playlists64540 -Node: Editing Tracks65699 -Node: Emms Mode Line69373 -Node: Limiting70541 -Node: Music Player Daemon72880 -Node: Lyrics76393 -Node: Volume78441 -Node: Streaming Audio80229 -Ref: Streaming Audio-Footnote-180821 -Node: APE / FLAC Commands81172 -Node: Bookmarks81879 -Node: Managing Playlists82590 -Node: GNU FM83613 -Node: Uploading Track Information84967 -Node: GNU FM Streaming85849 -Node: Copying86349 -Node: The GNU FDL123866 -Node: Concept Index146254 -Node: Function Index151112 -Node: Variable Index166804 -Node: Keybinding Index169147 +Node: Installation8677 +Node: Compiling Emms9226 +Node: Setup9914 +Node: Configuration10900 +Node: Finding files and speed12375 +Node: Setup Examples13244 +Node: Getting Help15177 +Node: Formats and Freedom15755 +Node: Basic Commands16960 +Node: The Core File20341 +Node: User Variables20775 +Node: Hooks21751 +Node: Core Functions23177 +Node: Sources26177 +Node: Simple Players28310 +Node: Playlists29367 +Node: Track Information30648 +Node: Metadata Utilities35358 +Node: Defining Info Methods40030 +Node: Interactive Playlists42174 +Node: Markable Playlists45216 +Node: Extending Emms47687 +Node: New Player48123 +Node: Simple Player for `play'48512 +Node: More Complex Player50240 +Node: The Browser53247 +Node: Browser Interface54223 +Node: Filtering Tracks56637 +Node: Displaying Covers58415 +Node: Changing Looks60429 +Node: Sorting Playlists63407 +Node: Persistent Playlists64876 +Node: Editing Tracks66035 +Node: Emms Mode Line69709 +Node: Limiting70877 +Node: Music Player Daemon73216 +Node: Lyrics76729 +Node: Volume78777 +Node: Streaming Audio80565 +Ref: Streaming Audio-Footnote-181157 +Node: APE / FLAC Commands81508 +Node: Bookmarks82215 +Node: Managing Playlists82926 +Node: GNU FM83949 +Node: Uploading Track Information85303 +Node: GNU FM Streaming86185 +Node: Copying86685 +Node: The GNU FDL124202 +Node: Concept Index146590 +Node: Function Index151448 +Node: Variable Index167140 +Node: Keybinding Index169609  End Tag Table -- cgit v1.2.3