OpenMW cfg

This library provides tools for accessing the case insensitive virtual file system defined by OpenMW in openmw.cfg.

The location of the openmw.cfg file is determined by first using the global config file if it exists (in /etc/openmw on Linux, and /Library/Preferences/openmw on macOS; on windows this is skipped) and otherwise the location described in the OpenMW paths documentation. Config files are read recursively (using config=... lines; see Configuration Sources for details) and combined.

Supported Features

The ?userconfig?, ?userdata? and ?local? variables are supported, however ?global? is not since it is determined at build time and does not have a predictable default. The ?local? variable is determined by searching for openmw in the path and will not be replaced if openmw cannot be found (see docs for the value of local on your platform).

Custom locations of openmw.cfg

The starting path and can be overridden by end users using the environment variable OPENMW_CONFIG_DIR or OPENMW_CONFIG, to allow for systems that use a non-standard location.

OPENMW_CONFIG_DIR can contain multiple paths, separated by colons (or semicolons on Windows), and these paths will be searched in turn to find one which contains a file with the name openmw.cfg.