{"record":{"id":"416fb894d78dcdcd","repo":"remotion-dev/remotion","slug":"non-semantic-version-provided-only-releases-of-wh","errorCode":null,"errorMessage":"Non-semantic version provided. Only releases of Whisper.cpp are supported on Windows (e.g., 1.5.4). Provided version:\n\t\t${version}. See https://www.remotion.dev/docs/install-whisper-cpp/install-whisper-cpp#version for more information.","messagePattern":"Non-semantic version provided\\. Only releases of Whisper\\.cpp are supported on Windows \\(e\\.g\\., 1\\.5\\.4\\)\\. Provided version:\n\t\t(.+?)\\. See https://www\\.remotion\\.dev/docs/install-whisper-cpp/install-whisper-cpp#version for more information\\.","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/install-whisper-cpp/src/install-whisper-cpp.ts","lineNumber":65,"sourceCode":"\n\t\t\tresolve();\n\t\t});\n\t});\n};\n\nconst installForWindows = async ({\n\tversion,\n\tto,\n\tprintOutput,\n\tsignal,\n}: {\n\tversion: string;\n\tto: string;\n\tprintOutput: boolean;\n\tsignal: AbortSignal | null;\n}) => {\n\tif (!getIsSemVer(version)) {\n\t\tthrow new Error(`Non-semantic version provided. Only releases of Whisper.cpp are supported on Windows (e.g., 1.5.4). Provided version:\n\t\t${version}. See https://www.remotion.dev/docs/install-whisper-cpp/install-whisper-cpp#version for more information.`);\n\t}\n\n\tconst url =\n\t\tversion === '1.5.5'\n\t\t\t? 'https://remotion-ffmpeg-binaries.s3.eu-central-1.amazonaws.com/whisper-bin-x64-1-5-5.zip'\n\t\t\t: `https://github.com/ggerganov/whisper.cpp/releases/download/v${version}/whisper-bin-x64.zip`;\n\n\tconst filePath = path.join(process.cwd(), 'whisper-bin-x64.zip');\n\tconst fileStream = fs.createWriteStream(filePath);\n\n\tawait downloadFile({\n\t\tfileStream,\n\t\tprintOutput,\n\t\turl,\n\t\tonProgress: undefined,\n\t\tsignal,\n\t});","sourceCodeStart":47,"sourceCodeEnd":83,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/install-whisper-cpp/src/install-whisper-cpp.ts#L47-L83","documentation":"Thrown by the Windows install path of `installWhisperCpu` when the `version` argument does not look like a semantic version. On Windows, Remotion only ships pre-built binaries for tagged whisper.cpp releases, so a version like 'latest', a branch name, or a commit hash is rejected. The validation regex is `/^[\\d]{1}\\.[\\d]{1,2}\\./`, requiring a leading `X.Y.` such as `1.5.5`.","triggerScenarios":"Calling `installWhisperCpu({version: 'latest'})`, `installWhisperCpu({version: 'master'})`, or a commit SHA on Windows. Also fails for malformed strings like 'v1.5.5' (leading 'v') because the regex expects a digit first.","commonSituations":"Copying a version format from macOS/Linux instructions that allow building from source; passing a Git ref instead of a release tag; including a leading 'v' prefix.","solutions":["Pass a release version in `X.Y.Z` form, e.g. `installWhisperCpu({version: '1.7.0'})`.","Drop any leading 'v' so the string starts with a digit.","Check the whisper.cpp releases page for the latest tag Remotion supports."],"exampleFix":"// before\ninstallWhisperCpu({version: 'v1.5.5', to: 'whisper'});\n\n// after\ninstallWhisperCpu({version: '1.5.5', to: 'whisper'});","handlingStrategy":"validation","validationCode":"function isReleaseVersion(v: string): boolean {\n  return /^\\d{1}\\.\\d{1,2}\\./.test(v);\n}\n\nif (process.platform === 'win32' && !isReleaseVersion(version)) {\n  throw new Error('On Windows, pass a whisper.cpp release version like 1.7.0');\n}","typeGuard":"function isWindowsReleaseVersion(v: string): boolean {\n  return /^\\d{1}\\.\\d{1,2}\\./.test(v);\n}","tryCatchPattern":null,"preventionTips":["On Windows, always pass a tagged release version (e.g. '1.7.0'), not 'latest' or a commit hash.","Strip a leading 'v' from version strings before passing them.","Pin the version in config rather than deriving it from a Git ref."],"tags":["whisper","windows","validation","version"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}