Troubleshooting Cantabile

The following notes describe how to locate log files and crash mini-dumps for diagnosing problems with Cantabile.

Before continuing, please read the current release notes as the issue you're encountering may already be fixed, or a work around suggested.

Please understand that any application that hosts plugins and modules developed by others is susceptible to crashes and other problems due to different interpretations of technical specifications by the developers involved. The extensive range of VST plugins available makes it impossible for us to test Cantabile with all plugins.

Cantabile includes a logging and tracing capability to help diagnose these problems.

Locating Cantabile Log File

Cantabile creates a log file that can be used for diagnostic purposes. To locate this file,, choose Open Setting Folder from the Tools menu

This will launch Windows Explorer in the correct location. The log file is named log.txt and often there will be a log file from the previous run named log-previous.txt.

Console Logger

Sometimes it's handy to view log files in real-time. Cantabile supports this via it's "console logger" option. When enabled a second window appears that displays log messages.

You should not enable the console logger during live performance as it can severely impact performance and audio stability of the system.

To enable the console logger:

You might also like to configure which types of events to log. For examples if dealing with MIDI integration issues you might like to turn on the Log MIDI In Events option to see MIDI events received by Cantabile.

Crash Reports

If Cantabile crashes it will automatically create a crash report file and prompt you to send it for diagnosis. The crash report includes details about the crash, a copy of your settings file and a copy of your plugin information file.

If you're concerned about privacy you can inspect the generated crash report (it's just zip file) before deciding to send it (click the "Show Files" button in the crash report window).

Reporting Faults

When reporting faults, try to include as much information as possible, including:

In the case of a crash, please include the mini-dump that Cantabile should have automatically created (see above).

All fault reports should be sent by email - see the contact page for details.

Thanks

Thanks for your time and effort in helping improve the quality of Cantabile! We take all fault reports seriously and you can generally expect to receive a reply with 24 hours.