release
dev builds
extras
themes manual
wiki
device status forums
mailing lists
IRC bugs
patches
dev guide



Search | Go
Wiki > Main > CustomFiletypeColours

Custom Filetype Colours



Description

Rockbox has the capability to modify the File Browser to show different filetypes in different colours, depending upon the file extension.

It makes your file view look something like this:

This is achieved by creating or modifying a .colours file and then activating the option using a config file.



Location

The .colours file should be stored in /.rockbox/themes. It is a simple text file and can be created from scratch, or a sample can be copied from /.rockbox/docs



Syntax

The file syntax is the file extension (or folder) followed by a colon and then the colour required as an RGB value in hexadecimal.

folder:808080
ipod:00B0B0
mp3:00FF00
flac:00FF00
ogg:00FF00
txt:FF0000
cfg:D00000
???:AABBCC

The only limitation is that the extension must be one of Rockbox's 'known' filetypes, as listed in filetypes.c. This does not include, for example, .config. It also recognises the firmware extensions (.ipod, .mi4 etc.). The last item in the above example (???) is the colour to use for files which are not recognised.


Activation

In order to activate the filetype colours option, it has to be invoked from within a standard Rockbox configuration file (*.cfg). The easiest way is to create a new text file containg 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 colours.cfg in the /.rockbox/themes directory and then activate the config file from the menu as normal (Settings > Theme Settings > Browse Themes)

Alternatively, you could save a config file (Settings > Manage Settings > Save .cfg File), edit the filetype colours entry and then select your re-saved config file.



Editing

The built-in Text Editor automatically understands the file format, but an external text editor can also be used.

To edit the .colours file using Rockbox, just select it in the File Browser. The file will open in the Text Editor. Click on a line to edit it and the following choice will appear:

If Extension is selected, the virtual keyboard appears, allowing the file extension to be modified.

If Color is selected, the standard colour selector screen appears (as per changing foreground and background colours)


r5 - 17 Nov 2008 - 11:53:30 - JonathanGordon

Parents: WebHome
Copyright by the contributing authors.