path: root/manual
diff options
authorChristian Soffke <>2021-11-19 05:11:13 +0100
committerWilliam Wilgus <>2022-01-22 08:29:40 -0500
commitbc5a6385949c9f0a17173f3512aa9a6db9175803 (patch)
treeb7b2990a4a43d6027f19cbe32a22cd2f0774d0b1 /manual
parentaafe2dd2d14e1ce88b5c9c819277ca0bc98af6e5 (diff)
Option to switch off album art or to prefer file over embedded
Large embedded album art can cause pauses during playback or when skipping between tracks, especially on older devices, but embedded art is currently loaded even when separately stored smaller image files would be available. A workaround is to remove large album art from the metadata of files. This now adds a setting to either turn off loading of album art completely, or to prefer loading the album art from a separate image file and thus ignore the embedded versions. Change-Id: I22fb581abf56072e35e6c29d72e553747ec1a96a
Diffstat (limited to 'manual')
2 files changed, 12 insertions, 0 deletions
diff --git a/manual/appendix/config_file_options.tex b/manual/appendix/config_file_options.tex
index b7e807baf4..09bc148535 100644
--- a/manual/appendix/config_file_options.tex
+++ b/manual/appendix/config_file_options.tex
@@ -132,6 +132,10 @@
rewind duration on pause & 0 to 15 & s\\
disable autoresume if phones not present & off, on & N/A\\ Logging & off, on & N/A\\
+ \opt{albumart}{
+ album art
+ & off, prefer embedded, prefer image file & N/A\\
+ }
talk dir & off, number, spell& N/A\\
talk dir clip & off, on & N/A\\
talk file & off, number, spell& N/A\\
diff --git a/manual/configure_rockbox/playback_options.tex b/manual/configure_rockbox/playback_options.tex
index 6c8f5de316..2619125e5e 100644
--- a/manual/configure_rockbox/playback_options.tex
+++ b/manual/configure_rockbox/playback_options.tex
@@ -324,3 +324,11 @@ you to configure settings related to audio playback.
your audio. This is typically 44.1kHz.}
\note{Opus files are always 48kHz.}
+ \section{Album Art}
+ Album art will not be loaded or displayed when set to \setting{Off}.
+ To prefer loading album art that is stored in a separate image file, set to
+ \setting{Prefer Image File}. The default behavior is to
+ \setting{Prefer Embedded} album art.
+} \ No newline at end of file