Mescaline’s runtime behavior can be modified in various ways with a simple configuration file.
The syntax is identical to the one used in Windows INI files, and consists of a default section and various subsections with configuration settings; have a look at the default configuration file.
Configuration file location
The user configuration file is named config and is expected to be in the user application data directory:
| OS | Path |
|---|---|
| Linux | ~/.Mescaline/ |
| MacOS | ~/Library/Application Support/Mescaline/ |
| Windows | C:/Documents And Settings/<USER>/Application Data/Mescaline/ |
Configuration variable types
| Type | Description | Values |
|---|---|---|
| String | Character string | Any string |
| Number | Numeric value | Any real number |
| Bool | Boolean value | true, false |
| Color | Color specification | |
| SynthDef | Synthdef name without extension; synthdefs are searched in the synthdefs subdirectory of the user application data directory |
|
| DumpLevel | Dump level for OSC messages in scsynth | none, hex, text, all |
| LogLevel | Log level | DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY |
Configuration variables
| Section | Variable | Description | Possible values | Default value |
|---|---|---|---|---|
| Synth | logLevel | Log level for the synthesizer | LogLevel | NOTICE |
| dumpOSC | OSC dump level for scsynth | DumpLevel | none | |
| sendEffect1 sendEffect2 |
SynthDef names for the effect buses | SynthDef | empty |