Chapter 29. Settings File and Environment Variables

Table of Contents

29.1. Possible Locations of mevislab.prefs
29.2. Options in mevislab.prefs
29.3. Environment variables

MeVisLab reads a settings file, mevislab.prefs, on startup that can be used to configure certain settings that may not be available through the GUI.

There are also some environment variables that change the behavior of MeVisLab in certain places.

29.1. Possible Locations of mevislab.prefs

This settings file is searched for in various places. If the file exists in more than one place, all files are evaluated, but if contradicting settings are given, the last file wins. The searched locations are:

  • First the directory of the MeVisLab executable (.../MeVisLab/IDE/bin).

  • Then, depending on the platform:

    • Windows

      1. The user's home directory

      2. The user's document folder

      3. The folder "MeVis" in the user's document folder

    • Linux

      1. Directory $HOME/.local/share/MeVis/MeVisLab

      2. The user's document folder

      3. The folder "MeVis" in the user's document folder

    (This can be suppressed by adding the -ignoreprefs command line option.)

  • The file name is defined by the MEVISLAB_PREFS environment variable. Also suppressed by -ignoreprefs.

  • The file name is specified after the -prefs command line option.

For applications created with MeVisLab, the same search rules apply. However, the "MeVisLab" part in the file, directory, or environment variable name must be replaced by the application name. This replacement should use uppercase, lowercase, or camel case corresponding to how MeVisLab is spelled in the rules provided above.