From c75a844e862f4fa1d7d03e1e4f11b8914b4654a4 Mon Sep 17 00:00:00 2001 From: Dominik Riebeling Date: Tue, 4 Apr 2006 21:48:47 +0000 Subject: First section to describe tagcache. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@9504 a1c6a512-1295-4272-9138-f99709370657 --- manual/rockbox_interface/main.tex | 6 +++++ manual/rockbox_interface/tagcache.tex | 49 +++++++++++++++++++++++++++++++++++ 2 files changed, 55 insertions(+) create mode 100644 manual/rockbox_interface/tagcache.tex (limited to 'manual/rockbox_interface') 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 folders and executing the default action on each file. To help us differentiate files, each file format is displayed with an icon. You can select which file types are displayed (see page \pageref{ref:ShowFiles}). +\note{When Tag Cache is enabled you will access the Tag Cache browser instead + of the File Browser. With Tag Cache you will be able accessing your music + using a database but won't be able doing any file manipulations. + Read more about Tag Cache in Section \ref{ref:tagcache}. +} \subsection{\label{ref:controls}Controls} \begin{table}[h!] @@ -289,6 +294,7 @@ This is the virtual keyboard that is used when entering file names in Rockbox. \end{table} } +\input{rockbox_interface/tagcache.tex} \section{\label{ref:WPS}While Playing Screen} The 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 @@ +% $Id$ % +\section{Tag Cache\label{ref:tagcache}} + +\subsection{Introduction} +Tag Cache is Rockbox's music database system. Using the information +contained in the tags (ID3v1, ID3v2, Vorbis Comments, Apev2, etc.) in your +audio files, Rockbox builds and maintains a database of the music files on +your player and allows you to browse them by Artist, Album and Genre. + +\subsection{Using Tag Cache} +Before you use the Tag Cache for the first time, you need to tell Rockbox to +create the database from your music files. This typically takes around +5 -- 10 minutes and you can continue listening to music normally whilst +this is happenning. You can even shut down your player and resume the +database building process next time you turn it on. +To force the initial database to be built, go to the main menu, then +General Settings $\rightarrow$ Playback $\rightarrow$ Force tag cache update. + +The Tag Cache database can either be kept on disk (to save memory), or +loaded into RAM (for fast browsing). This configuration option can be +found in General Settings $\rightarrow$ Playback $\rightarrow$ Tag cache. +Once the database has been built, you can browse your music using this +database. To use the database change the show mode by changing the General Settings $\rightarrow$ File view $\rightarrow$ Show files option to +``ID3 database''. This disables the File Browser and instead of the file +browser you will now access the database. + +\note{You may need to increase the value of the ``Max files in dir browser'' +setting (General Settings $\rightarrow$ System $\rightarrow$ Limits) +in order to view long lists of tracks in the ID3 database browser.} + +\begin{table} +\begin{center} + \begin{tabularx}{.75\textwidth}{XX} + \toprule + Supported Tags & Unsupported Tags \\ + \midrule + Artist & Comment \\ + Album & Performer\\ + Bitrate & \\ + Composer & \\ + Genre & \\ + Length & \\ + Title & \\ + Track Number & \\ + \bottomrule + \end{tabularx} +\end{center} +\end{table} + -- cgit v1.2.3