Introduction

By using the settings dialog BrainStim users can configure their setting and configuration preferences. You can open the settings dialog from BrainStim by selecting the menu commands: Tools --> Options.

Configuration File

Custom configured BrainStim settings are saved in the BrainStim configuration file. This file is located in the Main User Directory under the filename BrainStim.ini.

Settings

The settings dialog contains a selectable tabular bar that divides all the settings in different groups. Available settings are:

Tab	Setting	Description
General:
	Skip automatic QT Script binding loading	If you check this setting then the script bindings (located in <Main Program Directory>\Plugins\<Architecture>\script\) will not be automatically loaded at the next BrainStim startup and therefore their functionality is then also not available in the script engine.
	Allow multiple instances of BrainStim	When checked then multiple instances of BrainStim are allowed to run simultaneously as a separate BrainStim process on the same computer. If this setting is unchecked and you would try to start another instance of BrainStim by executing again the executable then this process is automatically stopped by the first instance. A situation where this setting could be useful is when you would associate BrainStim in Windows with a particular file type extensions, see this document for more information.
	Enable custom User Logins	This setting can be used to enable a custom BrainStim login option, if this option is enabled then you first need to login/register an account to make use of BrainStim the next time it starts. This options can be useful in situations where you want to be able to store custom BrainStim-user account settings separately while using the same Windows-user account. See this document for more information.
Directories:
	Main User Directory	Using this setting you can reconfigure the path of the Main User directory. Important! Although the BrainStim Settings File (BrainStim.ini) is located inside this directory by default the location of this file doesn't change by changing this setting, for all the remaining directories and files it does.
	Custom Plugin Directory	Using this setting you can reconfigure the path of the Custom Plugin directory. Important! After changing this setting you should copy all needed Plugin files from the "old" directory setting to this "new" directory setting for the plugin(s) that you still want to make use of in BrainStim.
Renderer:
	3D Renderer	Here you can configure the type of 3D renderer used.
Scripting:
	Include Directories	By using this setting you can configure the standard directories, and the order of them, that BrainStim uses for locating file(s) included by a script. See this document for more information.
Network:
	Network Server	BrainStim can be controlled over a network by enabling a Internal Network Interface, see this document for more information. If needed you can also specify here which IP-Address and Port should be used for the interface setup. You can leave the IP-Address setting empty for auto-discovery and if you leave the Port setting set to '0' then a free Port number is automatically assigned to it.
Updates:
	Updates Directory	This directory is fixed and therefore read-only here. This directory is used by BrainStim for installing some automatic updates each time a new user starts BrainStim for the first time.
	Manual update	Here you can browse and select a path to a root directory that contains the updates, subdirectories are automatically included. Found updates are then automatically installed.
Plugins:
	Properties	These settings are automatically implemented by the installed and enabled plugins. The by default available ExperimentManager plugin implements a Automatic EXML File Validation setting allowing you to disable the automatic validation of an EXML (*.exml) file when opened by BrainStim, because this may lead to unwanted additional loading time of such an document. If there are some custom plugins installed then these may also provide some custom configurable settings inside a dedicated tab.