Chapter 28. Settings File and Environment Variables

Table of Contents

28.1. Possible Locations of mevislab.prefs
28.2. Options in mevislab.prefs
28.3. Environment variables

MeVisLab reads a settings file mevislab.prefs on start-up that can be used to set certain settings that in some case are not available through the GUI.

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

28.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, on macOS, the application bundle resources folder.

  • 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

    • macOS

      1. The user's home directory

      2. The user's application support folder for the application.

      3. The "Settings" directory in the folder above.

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

  • The file given through the MEVISLAB_PREFS environment variable. Also suppressed by -ignoreprefs.

  • The file given after the -prefs command line option.

For applications created with MeVisLab the same search rules apply, but the "MeVisLab" part in the file/directory/environment variable name must be replaced by the application name, with the use of upper/lower/camel-case case corresponding to how MeVisLab is spelled in the rules given above.