Specifications

DRAFT VERSION
CHAPTER 3. THE ROCKBOX INTERFACE 18
section.
3.3.3. The Tag Cache Menu
Auto Update: If AUTO UPDATE is set to ON, each time the player boots, Tag Cache will
automatically do everything that the UPDATE NOW setting does. Note that the
AUTO UPDATE will only check for deleted files if the Directory Cache (GENERAL
SETTINGS → SYSTEM → DISK → DIRECTORY CACHE) is enabled. UPDATE 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 INITIALIZE NOW function in the TAG CACHE MENU. INITIALIZE
NOW 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: UPDATE NOW causes Tag Cache to detect new and deleted files Note
that unlike the AUTO UPDATE function, UPDATE NOW will update the database
regardless of whether the DIRECTORY CACHE is enabled. Thus, an update using
UPDATE NOW may take a long time. Unlike INITIALIZE NOW, the UPDATE NOW
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 SHOW FILES show
mode by changing the GENERAL SETTINGS → FILE VIEW → SHOW FILES option to ID3
DATABASE. This disables the FILE BROWSER and instead allows you to view files using
THE ROCKBOX MANUAL ARCHOS STUDIO/PLAYER