summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--manual/rockbox_interface/main.tex6
-rw-r--r--manual/rockbox_interface/tagcache.tex49
2 files changed, 55 insertions, 0 deletions
diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex
index 9054163e60..8360ec52f3 100644
--- a/manual/rockbox_interface/main.tex
+++ b/manual/rockbox_interface/main.tex
@@ -41,6 +41,11 @@ The file browser helps you navigate through the files on your \dap, entering
41folders and executing the default action on each file. To help us differentiate 41folders and executing the default action on each file. To help us differentiate
42files, each file format is displayed with an icon. You can select which file 42files, each file format is displayed with an icon. You can select which file
43types are displayed (see page \pageref{ref:ShowFiles}). 43types are displayed (see page \pageref{ref:ShowFiles}).
44\note{When Tag Cache is enabled you will access the Tag Cache browser instead
45 of the File Browser. With Tag Cache you will be able accessing your music
46 using a database but won't be able doing any file manipulations.
47 Read more about Tag Cache in Section \ref{ref:tagcache}.
48}
44 49
45\subsection{\label{ref:controls}Controls} 50\subsection{\label{ref:controls}Controls}
46\begin{table}[h!] 51\begin{table}[h!]
@@ -289,6 +294,7 @@ This is the virtual keyboard that is used when entering file names in Rockbox.
289 \end{table} 294 \end{table}
290} 295}
291 296
297\input{rockbox_interface/tagcache.tex}
292 298
293\section{\label{ref:WPS}While Playing Screen} 299\section{\label{ref:WPS}While Playing Screen}
294The While Playing Screen (WPS) displays various pieces of information about the 300The While Playing Screen (WPS) displays various pieces of information about the
diff --git a/manual/rockbox_interface/tagcache.tex b/manual/rockbox_interface/tagcache.tex
new file mode 100644
index 0000000000..3710ccfbd2
--- /dev/null
+++ b/manual/rockbox_interface/tagcache.tex
@@ -0,0 +1,49 @@
1% $Id$ %
2\section{Tag Cache\label{ref:tagcache}}
3
4\subsection{Introduction}
5Tag Cache is Rockbox's music database system. Using the information
6contained in the tags (ID3v1, ID3v2, Vorbis Comments, Apev2, etc.) in your
7audio files, Rockbox builds and maintains a database of the music files on
8your player and allows you to browse them by Artist, Album and Genre.
9
10\subsection{Using Tag Cache}
11Before you use the Tag Cache for the first time, you need to tell Rockbox to
12create the database from your music files. This typically takes around
135 -- 10 minutes and you can continue listening to music normally whilst
14this is happenning. You can even shut down your player and resume the
15database building process next time you turn it on.
16To force the initial database to be built, go to the main menu, then
17General Settings $\rightarrow$ Playback $\rightarrow$ Force tag cache update.
18
19The Tag Cache database can either be kept on disk (to save memory), or
20loaded into RAM (for fast browsing). This configuration option can be
21found in General Settings $\rightarrow$ Playback $\rightarrow$ Tag cache.
22Once the database has been built, you can browse your music using this
23database. To use the database change the show mode by changing the General Settings $\rightarrow$ File view $\rightarrow$ Show files option to
24``ID3 database''. This disables the File Browser and instead of the file
25browser you will now access the database.
26
27\note{You may need to increase the value of the ``Max files in dir browser''
28setting (General Settings $\rightarrow$ System $\rightarrow$ Limits)
29in order to view long lists of tracks in the ID3 database browser.}
30
31\begin{table}
32\begin{center}
33 \begin{tabularx}{.75\textwidth}{XX}
34 \toprule
35 Supported Tags & Unsupported Tags \\
36 \midrule
37 Artist & Comment \\
38 Album & Performer\\
39 Bitrate & \\
40 Composer & \\
41 Genre & \\
42 Length & \\
43 Title & \\
44 Track Number & \\
45 \bottomrule
46 \end{tabularx}
47\end{center}
48\end{table}
49