FluidSynth configuration files

These are the defined names and locations of the configuration file which is automatically loaded at startup if the client application implements the mechanism. Currently only the CLI program ("fluidsynth.exe" in Windows) honors this feature.

For application developers willing to implement this feature in their own clients, please see:

• char * fluid_get_userconf (char *buf, int len)
  https://www.fluidsynth.org/api/group__command__interface.html#ga331346c938f00a657325f3a0b66f793f
• char * fluid_get_sysconf (char *buf, int len)
  https://www.fluidsynth.org/api/group__command__interface.html#ga6e8489153a1c2041e526a3b27644c36d

User configuration

The user configuration file takes precedence over the system configuration. If both are found, only the user configuration shall be processed.

Unix

The user configuration file is located at the $HOME directory with the name: "~/.fluidsynth"

Windows

The user configuration file is located at the %USERPROFILE% directory with the name: "%USERPROFILE%\fluidsynth.cfg"

System wide configuration

Unix

The system configuration file is located at the "/etc" directory with the name: "/etc/fluidsynth.conf"

Windows

The system configuration file is located at the %ProgramData% directory with the name "%ProgramData%\fluidsynth\fluidsynth.cfg"

Example configuration file

This would be a valid configuration file for Linux:

set audio.driver pulseaudio
set audio.period-size 512
set audio.periods 8
set midi.driver alsa_seq
set midi.alsa_seq.id fluidsynth
set midi.autoconnect True
set synth.gain 1.0
set synth.chorus.active False
set synth.default-soundfont /home/user/.local/share/soundfonts/default.sf2