In snowberry you can customize the user interface in several ways. For example you can
Snowberry is an open source project: it is available for anyone and free to be modified (under GNU GPL).
As part of Snowberry's plugin architecture, files have been divided into two different places: the original system-specific installation folder (symbol <SYSTEM>), i.e. C:\Program Files\Snowberry, and the user-specific folder (symbol <HOME>), i.e.: C:\Documents and Settings\John\.snowberry.
The system-specific folders of the application (<SYSTEM>\):
\addons \conf \lang \plugins \profiles \graphics
The user-specific folders of the application (<HOME>\):
\addons \conf \lang \plugins \profiles \graphics \uninstalled \runtime
Only the user-specific folders are used via the user interface of the application. For example addons must be copied to the system-specific folder \addons by hand if needed. In \uninstalled there are the addons which you have uninstalled some time earlier and in \runtime there are i.e. files Options.rsp and log file conflicts.log. The first one contains the command line options used last time, and the second gathers the conflicts between addons attempted to load.
See also: snowberry_configuration_file_syntax
The term configuration file is used here to refer to many kinds of files:
Addons and plugins can customize Snowberry by providing their own configuration data. For example, an addon can define settings that will appear in the settings_tab when the addon is selected for loading.
Snowberry has its own format for configuration files. It is a text-based format reminiscent of Doomsday's ded_files.
In conf/ folder there is four configuration files that are used to configure Snowberry and Doomsday Engine:
Below is an example of what the definition of a setting might look like:
toggle run-in-window ( option: -wnd default: no )
Here is another example from a .lang file:
Configure definitions may define any settings for Snowberry, i.e. the location of Doomsday, or the title and version of Snowberry as in Snowberry.conf [6.3]. These settings are only used by Snowberry itself.
An example on the Windows platform:
configure doomsday ( binary: ..\Bin\Doomsday.exe base: .. )
Appearance definitions are being used for defining styles of labels in Snowberry UI. One appearance definition is for one text style. Together these work like a CSS stylesheet.
An example of an appearance definition:
appearance style-italic ( size: 9 weight: normal slant: italic )
Keys common to all settings:
Snowberry implements a number of different setting types [5.2]: “toggle”:
choice renderer (
option: -gl default: opengl alts < opengl, direct3d > opts < "drOpenGL.dll", "drD3D.dll" > ) * existing: This is a special keyword. It allows adding new alternatives to an existing choice setting. For example, assuming a choice setting called "game" has already been defined, the following definition would add one new alternative to it, without modifying the existing setting in any other way. choice game ( existing: merge alts < myowngame > opts < "myown.dll" > )
Profile files use the configuration file syntax as well. In this section the contents of .prof profile files will be described.