
Chapter 11.
Advanced Topics
168
Set-up
There are two steps to changing the filetype colours – creating a file with the extension
.colours
and then activating it using a config file. The
.colours
files
must
be stored
in the
/.rockbox/themes/
directory. The
.colours
file is just a text file, and can be
edited with your text editor of choice.
Creating the .colours file
The
.colours
file consists of the file extension (or
folder
) followed by a colon and then
the colour desired as an RGB value in hexadecimal, as in the following example:
folder:808080
mp3:00FF00
ogg:00FF00
txt:FF0000
???:FFFFFF
The permissible extensions are as follows:
folder, m3u, m3u8, cfg, wps, lng, rock, bmark, cue, colours, mpa, gigabeat,
mp1, mp2, mp3, ogg, oga, wma, wmv, asf, wav, flac, ac3, a52, mpc, wv, m4a,
m4b, mp4, mod, shn, aif, aiff, spx, sid, adx, nsf, nsfe, spc, ape, mac, sap,
mpg, mpeg, bmp, fnt, kbd
All file extensions that are not either specifically listed in the
.colours
files or are not
in the list above will be set to the colour given by
???
. Extensions that are in the above
list but not in the
.colours
file will be set to the foreground colour as normal.
Activating
To activate the filetype colours, the
.colours
file needs to be invoked from a
.cfg
con-
figuration file. The easiest way to do this is to create a new text file containing the
following single line:
filetype colours:
/.rockbox/themes/filename.colours
where filename is replaced by the filename you used when creating the
.colours
file.
Save this file as e.g.
colours.cfg
in the
/.rockbox/themes
directory and then activate
the config file from the menu as normal (
Settings
→
Theme Settings
→
Browse
Theme Files
).
The Rockbox manual
Toshiba Gigabeat F and X Series