User Tools

Site Tools



This article gives you an overview of the snowberry user interface and its basic functionality, introducing the launcher to new users.

When you installed doomsday, the installer added a Snowberry icon to your desktop. Double-clicking this icon will start Snowberry.

The first time you run Snowberry, a wizard dialog will guide you through the basic configuration options. These include the display_resolution you prefer to use when running Doomsday and the location of the required_game_data_files (the iwads).

Overview of the user interface

The user interface is divided into six different areas:

Let's quickly discuss what you can see.

  • Top left: Defaults Tab. This tab will set the global settings for the games you have. So for instance you set the resolution to 1600×1200 in here and all the games will run at.
  • Left: The actual games you have. You can click on them to edit their individual properties and preferences or to select them to play them.
  • Bottom left - + (plus), - (minus) and dup (duplicate) buttons: Here you can add, remove or duplicate additional games once you aquire them.
  • Middle section: This is where the sub-tabs are located and where you will change your settings.
  • Right section: General info about Snowberry etc.

Let's look at the “Defaults” Tab. The sub-tabs it has available are called Summary, Maps, Addons and Settings.

Summary tab

This tab presents a profile-specific summary about loaded_addons (like the jDoom Resource Pack, and customized settings. It also has general information about the profile and tells the display resolution.

Maps tab

This show any additional wads that you have on your system if you've specified their folder during the installation.

Addons tab

All addons compatible with the current_profile and their contents are listed here in a tree hierarchy grouped by their category (graphics, sound etc.). You are able to install and uninstall addons to the tree and change their settings and loading order as well. These actions are done by the +, -, settings_button, or load_order_button or via the context menu.

Settings tab

See also: settings_tab

This is the tab where you will spend the most of your time. Here you change the actual engine settings, like display, graphic and sound options. If you want you can also add some command_line_options here.

The Settings tab shows the settings connected to the current_profile. They are in a list grouped by their category.

On this tab, in addition to managing profile settings, you can re-run the wizard for basic settings, set the language of the UI. You also have an option to leave snowberry running in the background while playing a game.

When the defaults_profile is selected you can change the default_settings for all profiles. While it is selected, the play_button is inactive. The settings groups called Snowberry, a group for every addon that is selected for loading in the current_profile, and the game-specific settings groups have now appeared.

Let's look at each sub-tab.


In this tab it is possible to change your language option, whether you want Snowberry to quit or not when you run the game, add additional folders to load addons from and change some user interface option. Please note that some of them require a restart of Snowberry to take effect.


Here you select which renderer you would like to use for the Doomsday Engine. There are 2 option. OpenGL and Direct3D. Select whichever your graphics card does fastest. You also get to select the resolution that you want to play the game at. The resolution has a huge impact on performance, so be realistic when you select this. The colour depth can be 16bit or 32bit. 32bit being better, albeit slower. You can select the option to run the game in a window if you need to as well.

Note that if you select to run the game in a window or select Direct3D as your renderer, extra option become available to use.

Graphics tab

Here you can adjust some graphic settings that influence how the Doomsday Engine handles graphics in the game.

Sound tab

This is where you select which driver is to render your sound to your speakers. You can even select not to render any sound at all. You can set the number of channels that the Engine can use to play sounds simultaneously, from 4 to 32, the default being 16. There are also options for disabling audio, sfx, music, setting the primary buffer and FMOD ( a plugin that allows you to play external file formats ). It also has EAX options which can be set.

Input tab

Here you can set whether you'd like your Windows keys, mouse or joystick disabled.

Developer tab

Here you set whether you want verbose messages displayed or not. You get to select which level of messages you get. There is also a space to add custom parameters that will be passed to the relevant exe ( ??? ).

Addons tab

This shows your added addons.

See also

snowberry/introduction_to_snowberry.txt · Last modified: 2007-06-09 20:34 (external edit)