Chapter 11.
Advanced Topics
176
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
176
) below for an explanation of the format for configuration
files. See section
11.3.3
(page
177
) 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
Save .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
199
) 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:
Example
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
when you are in the car, and a regular LCD setting when you are using headphones. You
could create configuration files that control only the volume and LCD settings. Create a
few different files with different settings, give each file a different name (such as
car.cfg
,
headphones.cfg
, etc.), and you can then use the
Browse .cfg files
option to quickly
change settings.
A special case configuration file can be used to force a particular setting or settings
every time Rockbox starts up (e.g. to set the volume to a safe level). Format a new
configuration file as above with the required setting(s) and save it into the
/.rockbox
directory with the filename
fixed.cfg
.
The Rockbox manual
Toshiba Gigabeat F and X Series