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.
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:
- Open Options (Tools -> Options)
- Switch to the Diagnostics page
- Turn on Console Logger option
- Press OK.
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.
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).
When reporting faults, try to include as much information as possible, including:
- Version and build number of Cantabile
- Operating system details
- Sound card type
- Audio driver details, including whether ASIO or DirectSound
- Details of any plugins that you feel may be related to the problem
- Steps to reproduce the problem
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 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.