SubtitleEdit/subtitleedit · error · FileNotFoundException

CrispASR executable not found. Install CrispASR via Video →

Error message

CrispASR executable not found. Install CrispASR via Video → Audio to text first.

What it means

FileNotFoundException from CosyVoice3CrispAsr.EnsureServerRunningAsync: GetCrispAsrExecutable() returned a path for which File.Exists is false. The crispasr binary is shared with the ASR feature and is expected to be installed first; CosyVoice3 TTS does not download it itself.

Source

Thrown at src/ui/Features/Video/TextToSpeech/Engines/CosyVoice3CrispAsr.cs:688

        }

        await ServerLock.WaitAsync(ct);
        try
        {
            if (MatchesCurrent())
            {
                return;
            }

            if (_serverProcess != null)
            {
                StopServerInternal();
            }

            var exe = GetCrispAsrExecutable();
            if (!File.Exists(exe))
            {
                throw new FileNotFoundException(
                    "CrispASR executable not found. Install CrispASR via Video → Audio to text first.", exe);
            }

            // crispasr's cosyvoice3-tts backend needs LLM + flow + hift + s3tok + campplus +
            // voices co-located as siblings of the LLM. We stage every file via SE's download
            // service into CrispAsr/models/, so when all are present we don't need
            // --auto-download. If any required file is missing, fall back to -m auto +
            // --auto-download which makes crispasr fetch the whole bundle into its own cache
            // (slower, no SE progress bar — happens silently behind the synth call).
            var llmFileName = GetLlmFileName(modelKey);
            var llmPath = GetLlmPath(modelKey);
            var allLocal = AreModelsInstalled(modelKey);

            var port = FindFreeLoopbackPort();
            var psi = new ProcessStartInfo
            {
                WorkingDirectory = Path.GetDirectoryName(exe) ?? GetSetFolder(),
                FileName = exe,

View on GitHub (pinned to 17a9f07487)

Solutions

Open Video → Audio to text and run transcription once so the shared CrispASR binary downloads.
Verify the path returned by GetCrispAsrExecutable() exists on disk and is readable.
Re-download CrispASR via Video → Audio to text → Engine settings → Re-download.
If AV quarantined the binary, whitelist the CrispAsr folder and re-download.

Defensive patterns

Strategy: validation

Validate before calling

var exe = CosyVoice3CrispAsr.GetCrispAsrExecutable(); // assume exposed
if (!File.Exists(exe))
{
    Se.WriteToolsLog("CrispASR not installed — run Video → Audio to text first.", true);
    return; // or prompt the user to install
}

Try / catch

try { await cosyVoice3Engine.Speak(text, out, voice, lang, region, model, ct); }
catch (FileNotFoundException ex) when (ex.Message.Contains("CrispASR executable not found", StringComparison.Ordinal))
{ Se.WriteToolsLog("Install CrispASR via Video → Audio to text, then retry.", true); }

Prevention

Gate the TTS UI on CrispASR being installed (check File.Exists on the exe).
Always run Audio-to-text once on a fresh install to populate the shared binary.
Whitelist the CrispAsr folder in AV so the binary is not quarantined.

When it happens

Trigger: EnsureServerRunningAsync proceeds past the MatchesCurrent cache check and the existing-server teardown, then calls GetCrispAsrExecutable() and File.Exists(exe) returns false.

Common situations: Fresh install where the user went straight to TTS without ever running Video → Audio to text; the crispasr binary was deleted/moved by AV cleanup; a portable install where the relative exe path resolved wrong; OS permission issue making the file invisible.

Related errors

AI-assisted analysis of SubtitleEdit/subtitleedit@17a9f07487 (2026-08-13). Data as JSON: /api/errors/4ba691cdf560e3ef. Report an issue: GitHub.