C
4. B
HAPTER
ROWSING AND PLAYING
4.2 Database
4.2.1 Introduction
This chapter describes the Rockbox music database system. Using the information con-
tained 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, Genre, Song Name, etc. The criteria the database
uses to sort the songs can be completely customised. More information on how to
achieve this can be found on the Rockbox website at ZDataBase.
4.2.2 Initializing the Database
The first time you use the database, Rockbox will scan your disk for audio files. This can
take quite a while depending on the number of files on your player. This scan happens
in the background, so you can choose to return to the Main Menu and continue to listen
to music. If you shut down your player, the scan will continue next time you turn it on.
After the scan is finished you may be prompted to restart your player before you can
use the database.
Ignoring Directories During Database Initialization
You may have directories on your player whose contents should not be added to the
database. Placing a file named database.ignore in a directory will exclude the files
in that directory and all its subdirectories from scanning their tags and adding them to
the database. This will speed up the database initialization.
If a subdirectory of an 'ignored' directory should still be scanned, place a file named
database.unignore in it. The files in that directory and its subdirectories will be
scanned and added to the database.
4.2.3 The Database Menu
Load To RAM The database can either be kept on disk (to save memory), or loaded
into RAM (for fast browsing). Setting this to Y
allowing faster browsing and searching. Setting this option to N
database on the disk, meaning slower browsing but it does not use extra RAM
and saves some battery on boot up.
Note: If you browse your music frequently using the database, you should load
to RAM, as this will reduce the overall battery consumption because the disk will
not need to spin on each search.
Auto Update If A
UTO UPDATE
will automatically be updated.
Note: The A
UTO
T
R
HE
OCKBOX MANUAL
is set to
ON
U
will only check for deleted files if the D
PDATE
loads the database to RAM,
ES
, each time the player boots, the database
26
keeps the
O
b
b
C
IRECTORY
ACHE
I
H3
RIVER
XX