From e70461dd1a1ad09c92a4d1753f94e95abc76eeb2 Mon Sep 17 00:00:00 2001 From: Pierre Neidhardt Date: Sat, 9 Dec 2017 16:30:01 +0100 Subject: Document dynamic cover thumbnail caching --- doc/emms.texinfo | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) (limited to 'doc/emms.texinfo') diff --git a/doc/emms.texinfo b/doc/emms.texinfo index 241dd6d..7531521 100644 --- a/doc/emms.texinfo +++ b/doc/emms.texinfo @@ -1651,12 +1651,25 @@ Show all files that are not in the pending directory: @section Displaying Covers The browser will attempt to display cover images if they're -available. By default it looks for images @file{cover_small.jpg}, -@file{cover_med.jpg}, etc. Customize @var{emms-browser-covers} and -@var{emms-browser-covers-file-extensions} to use your own covers. Note -that you'll probably want to resize your existing covers to particular +available. + +Customize @var{emms-browser-covers} to configure how EMMS should retrieve the +covers. + +By default it looks for images @file{cover_small.jpg}, @file{cover_med.jpg}, +etc. Note that you'll probably want to resize your existing covers to particular sizes. Suggested sizes are 100x100 for small, and 200x200 for medium. +The above behaviour demands manual processing on behalf of the user. Instead, +you might prefer to automate the process by setting @var{emms-browser-covers} to +'emms-browser-cache-thumbnail': covers matching 'emms-browser-thumbnail-filter' +will be automatically resized if necessary and cached to +@var{emms-browser-thumbnail-directory}. The cache gets automatically updated +upon change in the source folder. + +Customize @var{emms-browser-covers-file-extensions} to include or exclude +specific extensions. + Also, Emacs by default will jump around a lot when scrolling a buffer with images. In order to prevent that, you can set @var{scroll-up-aggressively} and @var{scroll-down-aggressively} to the -- cgit v1.2.3