Toshiba F Series Speci cations for .cfg Files, wps /.rockbox/car.wps lang /.rockbox/afrikaans.lng

Chapter 11. Advanced Topics 138

while playing your jukebox in your car, and a headphones.cfg le to store the settings that you use while listening to your player through headphones.

See section 11.3.2 (page 138) below for an explanation of the format for conguration les. See section 11.3.3 (page 139) for an explanation of how to create, edit and load conguration les.

11.3.2 Specications for .cfg Files.

The Rockbox conguration le is a plain text le, so once you use the Save .cfg file option to create the le, you can edit the le on your computer using any text editor program. See Appendix section C (page 150) for available settings. Conguration les 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 specied in this manual for each setting.

4.Lines starting with # are ignored. This lets you write comments into your cong- uration les.

Example of a conguration le:

Example

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, conguration les do not need to contain all of	b
the Rockbox options. You can create conguration les that change only certain settings.
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 conguration les that control only the volume and LCD settings. Create a few
dierent les with dierent settings, give each le a dierent 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 conguration le 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
conguration le as above with the required setting(s) and save it into the /.rockbox
directory with the lename fixed.cfg.

The Rockbox manual Toshiba Gigabeat F Series