Ctrl + Shift + D (Cmd + Shift + D on macOS) with the Settings window focused. A Debug item appears in the sidebar. Press it again to hide the section.
Most people never need anything in here.
What is in the Debug section
Turning debug mode on does not change how SpeakoFlow behaves, with one exception. It adds an extra After 15 seconds (Debug) choice to the model-unload dropdowns so reload behavior is quick to test.
When to change these
- Log level. Raise it to
Tracewhen reproducing a bug you are about to report.Debugis already fairly verbose, so most reports do not need it changed at all. - Paste delay. Raise it if the wrong text is occasionally pasted. That is usually the target app not having finished processing the clipboard change before the paste keystroke arrives.
- Extra recording buffer. Raise it if you consistently lose the last word or two. It is zero by default because voice-activity detection normally handles the tail.
- Word correction threshold. Raise it if custom words are still mistranscribed. Higher is more willing to treat a loosely similar word as a match, which risks rewriting words you actually said. The default is deliberately conservative.
Details
Where the log file is
Where the log file is
The log file is named
speakoflow and lives in your platform’s standard application log directory, or in Data/logs next to the executable in portable mode.Rather than documenting a path that varies by OS and install method, SpeakoFlow shows you the real one. Settings → About → Folders has both the log directory and the app data directory, each with a button that opens it in your file manager.Logs rotate at 500 KB and one previous file is kept, so they cannot grow without bound. A long session can therefore push out earlier detail, so capture the log soon after reproducing a problem.Log level versus RUST_LOG and --debug
Log level versus RUST_LOG and --debug
Console output is filtered separately by the
RUST_LOG environment variable. Running SpeakoFlow from a terminal with RUST_LOG=trace gives you a live firehose without touching this setting.Launching with the --debug flag raises logging to Trace for that run only, without writing anything to your saved settings. It does not reveal this section, because only the keyboard shortcut does that. See Command-line flags.Which models the word correction threshold affects
Which models the word correction threshold affects
It only affects the fuzzy correction pass, which is what non-Whisper models rely on.Whisper-family models get your custom words as a recognition prompt instead, so the threshold matters less to them.
Why the clamshell microphone row is sometimes missing
Why the clamshell microphone row is sometimes missing
The row appears only when SpeakoFlow detects an internal battery, so it never shows on a desktop Mac, Windows, or Linux.SpeakoFlow reads the lid state from the system and switches to this device automatically when the lid is shut. That is useful when your normal choice is the built-in microphone, which is unusable in clamshell mode.
Settings that used to be here
Settings that used to be here
Several rows moved out of Debug as the app was reorganized.