C
HAPTER
11. A
DVANCED
T
OPICS
107
11.3. Managing Rockbox Settings
11.3.1. Introduction to
.cfg
Files.
Rockbox allows users to store and load multiple settings through the use of configura-
tion files. A configuration file is simply a text file with the extension
.cfg
.
A configuration file may reside anywhere on the disk. Multiple configuration files
are permitted. So, for example, you could have a
car.cfg
file for the settings that you
use while playing your jukebox in your car, and a
headphones.cfg
file to store the
settings that you use while listening to your player through headphones.
See section
11.3.2
(page
107
) below for an explanation of the format for configuration
files. See section
11.3.3
(page
108
) for an explanation of how to create, edit and load
configuration files.
11.3.2. Specifications for
.cfg
Files.
The Rockbox configuration file is a plain text file, so once you use the S
AVE
.
CFG FILE
option to create the file, you can edit the file on your computer using any text editor
program. See Appendix section
C
(page
121
) for available settings. Configuration files
use the following formatting rules:
1. Each setting must be on a separate line.
2. Each line has the format “setting: value”.
3. Values must be within the ranges specified in this manual for each setting.
4. Lines starting with # are ignored. This lets you write comments into your config-
uration files.
Example of a configuration file:
E
XAMPLE
Example configuration file
volume: 70
bass: 11
treble: 12
balance: 0
time format: 12hour
volume display: numeric
show files: supported
wps: /.rockbox/car.wps
lang: /.rockbox/afrikaans.lng
Note:
As you can see from the example, configuration files do not need to contain all
b
of the Rockbox options. You can create configuration files that change only certain set-
tings. So, for example, supppose you typically use the player at one volume in the car,
and another when using headphones. Further, suppose you like to use an inverse LCD
T
HE
R
OCKBOX MANUAL
A
RCHOS
O
NDIO
