summaryrefslogtreecommitdiff
path: root/manual/appendix/album_art.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/appendix/album_art.tex')
-rw-r--r--manual/appendix/album_art.tex37
1 files changed, 37 insertions, 0 deletions
diff --git a/manual/appendix/album_art.tex b/manual/appendix/album_art.tex
new file mode 100644
index 0000000000..dc6a778320
--- /dev/null
+++ b/manual/appendix/album_art.tex
@@ -0,0 +1,37 @@
1% $Id: wps_tags.tex 19361 2008-12-07 23:00:15Z bluebrother $ %
2\chapter{\label{ref:album_art}Album Art}
3\section{Introduction}
4
5Rockbox allows you to put the album art, or another image related to the music
6on your \dap to display it in the PictureFlow plugin\opt{albumart}{ or in the
7WPS}. For this feature to work, you must observe a few rules.
8
9\section{Limitations}
10
11Rockbox does not support album art embedded in your files' tags, and will
12instead look for a picture located in the filesystem. In addition to this, the
13pictures must be in the BMP format.
14
15\section{Where to put album art}
16
17The pictures can be named a number of different ways, and placed a number of
18different locations. You can have pictures specific to the file or the album
19or use a generic picture. You can place the picture in the same direcotry
20as the file, in the parent directory or in a fixed directory named
21\fname{/.rockbox/albumart/}. The order Rockbox uses when looking for a picture
22is as follows:
23
24\begin{enumerate}
25\item \fname{./filename.bmp}
26\item \fname{./albumtitle.bmp}
27\item \fname{./cover.bmp}
28\item \fname{/.rockbox/albumart/artist-albumtitle.bmp}
29\item \fname{../albumtitle.bmp}
30\item \fname{../cover.bmp}
31\end{enumerate}
32
33The following characters will be replaced with an underscore (\_) when looking
34for albumtitle.bmp or artist-albumtitle.bmp: \textbackslash{} / : \textless{}
35\textgreater{} ? * \textbar{}. Doublequotes will be replaced by single qutoes.
36See \wikilink{AlbumArt} in the wiki for more details and programs that will
37help you automate the process of putting album art on your \dap{}.