DRAFT
VERSION
C
HAPTER
3. T
HE
R
OCKBOX INTERFACE
18
section.
3.3.3. The Tag Cache Menu
Auto Update:
If A
UTO UPDATE
is set to
ON
, each time the player boots, Tag Cache will
automatically do everything that the U
PDATE NOW
setting does. Note that the
A
UTO
U
PDATE
will only check for deleted files if the Directory Cache (G
ENERAL
S
ETTINGS
→
S
YSTEM
→
D
ISK
→
D
IRECTORY
C
ACHE
) is enabled. U
PDATE NOW
includes that check whether dircache has been enabled or not.
Initialize Now:
Before you use the Tag Cache for the first time, you must initialize it
by using the I
NITIALIZE
N
OW
function in the T
AG
C
ACHE
M
ENU
. I
NITIALIZE
N
OW
removes all database files (removing runtimedb data also) and rebuilds the
database from scratch. This takes approximately 5 to 10 minutes, and may require
a restart to allow the files to be committed to the cache.
The Tag Cache initialization happens in the background, so you can continue to
listen to music while the Tag Cache is being initialized. If you shut down your
player during initialization, the database building process will continue next time
you turn it on.
Update Now:
U
PDATE NOW
causes Tag Cache to detect new and deleted files Note
that unlike the A
UTO
U
PDATE
function, U
PDATE
N
OW
will update the database
regardless of whether the D
IRECTORY
C
ACHE
is enabled. Thus, an update using
U
PDATE NOW
may take a long time. Unlike I
NITIALIZE
N
OW
, the U
PDATE
N
OW
function does not remove runtime database information.
Gather Runtime Data (Experimental):
When enabled, this option allows the most
played, unplayed and most recently played tracks to be logged and scored.
Export modifications:
This allows for the runtime data to be exported into
/.rockbox/tagcache changelog.txt
, which backs up the runtime data in
ASCII format. This is needed when Tag Cache structures change, because new
code cannot read old Tag Cache database code. But, all modifications exported to
ASCII format should be readable by all Tag Cache versions.
Import modifications:
Allows the
/.rockbox/tagcache changelog.txt
backup
to be conveniently loaded into the Tag Cache. This is performed automatically
when the Tag Cache is initialized.
3.3.4. Using the Tag Cache
Once the Tag Cache has been initialized, you can browse your music by Artist, Al-
bum, Genre and Song Name. To use the Tag Cache, change the S
HOW
F
ILES
show
mode by changing the G
ENERAL
S
ETTINGS
→
F
ILE
V
IEW
→
S
HOW FILES
option to ID3
DATABASE
. This disables the F
ILE
B
ROWSER
and instead allows you to view files using
T
HE
R
OCKBOX MANUAL
A
RCHOS
S
TUDIO
/P
LAYER
