User Guides

Settings Folder

Cantabile stores all its global settings in the settings folder. The exact location of this file will depend on the version of Windows you're running, whether you're running the x86 or x64 version of Cantabile and whether you're running with an alternate configuration.

Locating the Settings Folder

The easiest way to locate the settings folder it to:

  1. Start Cantabile
  2. From the Tools menu, select Options
  3. Go the the Diagnostic page
  4. Click the "Open settings and log file folder"

This will launch Windows Explorer in the correct folder.

Moving the Settings Folder

Sometimes you might want to move the settings folder to a different location. This can be handy if you want to backup or synchronize your settings across machines with tools like Dropbox.

You can change the location of the settings folder by editing the config.json file that can be found in the same folder as Cantabile.exe:

{
    "settingsFolder": "%USERPROFILE%\\Documents\\Cantabile\\Settings"
}

Alternatively, starting with Cantabile 4, you can also set the settings folder with a command line option:

Cantabile.exe --settingsFolder:"%USERPROFILE%\\Documents\\Cantabile\\Settings"

The location specified here is the base settings folder location and will be appended with “Cantabile 4.0 (x64)” and the config name as per normal.

Note that this setting applies to all user accounts which is why in the above example it includes the %USERPROFILE% environment variable so that each user’s settings are kept separate.

Once you’ve changed this setting don’t forget to move all the files from the old location so you don’t need to reconfigure everything.

Finally, remember that the settings folder stores settings relevant to your hardware configuration. If you’re using this synchronize settings across machines you’ll need to be running the same hardware on each machine (or you’ll need to use different configuration names on each machine).

Setting Files

settings.json
This file is the main file in which all of Cantabile's global settings are saved.
plugins.json
Information all plugins shown by Cantabile's Insert Plugin window.
plugins.cache.json
Cached information from the previous plugin scan. Used when performing a quick plugin scan to save re-scanning previously scanned plugins.
plugins.user.json
User settings for plugins such as categories.
log.txt
Cantabile's debug log used for diagnostic purposes.
Cantabile-xxxxxxxxxxxxxxxxxxxxxxxxx.zip
Crash reports files contained detailed diagnostic information collected if Cantabile crashes. Typically these will be sent to Topten Software by the crash reporter program.