Cantabile supports various settings for diagnosing issues.
Many of these options when enabled will affect Cantabile's performance and should be turned off once you've finished diagnosing any issues. Cantabile will display a warning on startup if one or more of these options might adversely affect performance.
- Write Log File
- Writes a log file listing out operations as they occur in internally to Cantabile. The log is written to a file named
log.txtin the settings folder.
- Append Existing Log File
- When not selected, the previous log file is overwritten on each run. (A copy of one previous log file is kept as
- Log File Write Through
- Disables disk write caching on the log file to ensure every log entry is written. Prevents losing some log messages immediately prior to a crash or hang. Can severely affect performance - don't use unless necessary.
- Console Logger
- Displays the log messages in a separate popup window while Cantabile is running. Useful for diagnosing events in real-time.
- Verbose Loggin
- Logs more stuff :)
- Log VST MIDI Events
- Logs all MIDI events sent to plugins
- Log MIDI In Events
- Logs all incoming MIDI events
- Log MIDI Out Events
- Logs all outgoing MIDI events
- Open Settings Folder
- Launches Windows Explorer showing Cantabile's settings folder.
- Generate Crash Dumps
- Captures detailed error information if Cantabile a loaded plugin crashes. These files are essential in helping us resolve issues with Cantabile and after a crash dump is generated you'll be prompted to send it for diagnosis. Please do.
- Include Data Segments in Crash Dumps
- Captures a lot more information in the crash dump. So much that the file will be typically too large to email. Sometimes we'll ask for this to be turned on and we'll provide an upload location to send the file.
- Abort on Managed Exception
- Some exceptions can be safely ignored. Although these issued need to be investigate Cantabile will typically continue running to allow you to save your work. Sometimes we'll ask to turn this option on before reproducing an issue so we can capture additional information about the problem.
- Disable SSE and SSE2 Optimizations
- Disables various floating point math optimizations. You should never need to use these. Removed in build 3500 and later
- Disable Audio Engine Timeouts
- Cantabile tries to detect if the audio engine becomes unresponsive. This option disables that. You should never need to use this unless otherwise instructed.
- Don't Check For Clean Shutdown
- If at startup Cantabile detects that it didn't shutdown cleanly on the last run you'll be prompted with some recovery options. This option disables the recovery screen.
- Ignore ASIO Reset Requests
- Work around for some problematic ASIO drivers that send excessive/spurious reset requests. We'll generally advice to turn this on if we see appropriate error messages in debug logs you send.