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

 

di erent les with di erent settings, give each le a di erent 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

Page 138
Image 138
Toshiba F Series manual Specications for .cfg Files