Complete List of CFG Syntax for Themes

[Arwym]

Hello!

I hope you don't mind me asking this...  I have been searching everywhere.  Forums, manual, wiki, etc.  I still haven't been able to find a complete list of all the possible options for a custom theme's .cfg files.  I thought they all would be here, but they aren't.  I don't know where else to look for, and that is why I am asking.  I need a reference for this, so if you could help me find it, I will greatly appreciate it.  If it's in the wiki, then I am very sorry, but I really can't seem to find it.

Thank you for your time.

[karashata]

Why don't you just take a look at the various theme configuration files from the bundled themes with Rockbox (or themes you might have downloaded) and get an idea there what sorts of settings you might want to change from those?  I think the cabbiev2 theme's configuration file has most of the settings you might want to change (ie. font, selector type, colors, etc) so you could use that as an idea and make your own config file from there...

[ZincAlloy]

or just safe your settings in rockbox and take a look a the created .cfg file.

[bluebrother]

A theme file is simply a cfg file. There are no (technical) restrictions, so you can set any setting from a theme file if you wish. Obviously you shouldn't do so as a theme changing things like repeat mode or system settings would be quite confusing and annoying. The manual holds a list of cfg items (should be at least somewhat up to date), just pick those making sense for a theme

Oh, and if you use the "save theme settings" (not save settings) menu entry all settings that are considered theme-related get saved. But ZincAlloy already mentioned that.

[Arwym]

I know what you're trying to say...  I know what a .cfg file is and that I could add anything to it (from that list).  But I am talking about appearance-specific options that are missing in the documentation, or so it seems.  I have looked inside other themes' .cfg files, but I know that there might be options I could use that are missing in any of those.  I have several themes downloaded and I study them as I can.

What I am trying to say is that the list in the wiki is incomplete.  And I know that because options such as 'iconset' are not added to it.  If other theme authors were able to figure these out even when they were not included in the wiki, I want to know how and where they found the information, so that I can do the same, instead of having to ask every time and bother others.
I don't want to miss anything that I could use in the future.  But if something is not documented and I am not a developer, how do I know it exists?
I don't say this only for myself, but for others as well.  Others who might find themselves having the same questions.

Oh, and if you use the "save theme settings" (not save settings) menu entry all settings that are considered theme-related get saved. But ZincAlloy already mentioned that.

There's my solution, I think.  I suppose that some values will be obvious regarding the way in which they are entered.  But if I have doubts, I hope you don't mind that I come to ask.  >.<

If I knew exactly what I am doing, I'd try helping by adding the missing CFG setting options (that is, updating the information) to the list.  But I don't want to make a mistake and confuse things.

Again, thank you for your time.    I really appreciate it.

[bluebrother]

If I knew exactly what I am doing, I'd try helping by adding the missing CFG setting options (that is, updating the information) to the list.  But I don't want to make a mistake and confuse things.

Well, it's a wiki -- if you happen to add wrong information it's likely someone will rather soon fix it up. I think it's better to have an incomplete list than no list at all. And I'm quite sure you'll find missing items you're sure about. So don't worry too much ... we had wrong and outdated information in the wiki before and for sure will always have

[revnull]

This is what I was able to dig up.

Code: [Select]

# While Playing Screen Settings
wps: /.rockbox/wps/filename.wps
statusbar: on|off
scrollbar: on|off
volume display: graphic|numeric
battery display: graphic|numeric
font: /.rockbox/fonts/filename.fnt
# Menu Screen Settings
backdrop: /.rockbox/backdrops/filename.bmp
foreground color: 000000 to FFFFFF
background color: 000000 to FFFFFF
selector type: pointer|bar (inverse)|bar (color)|bar (gradient)
line selector start color: 000000 to FFFFFF
line selector end color: 000000 to FFFFFF
line selector text color: 000000 to FFFFFF
show icons: on|off
iconset: /.rockbox/icons/filename.bmp
viewers iconset: /.rockbox/icons/filename.bmp
kbd: /.rockbox/path/filename.kbd
filetype colours: /.rockbox/path/filename.colours

- Ray

[MarcGuay]

The full list is in the manual.  Although I suppose it's possible that things are missing from there as well.

http://download.rockbox.org/manual/rockbox-sansae200/rockbox-buildap3.html#x17-293000C

[revnull]

While true, the listed seem to be most appropriate for theme configs.