remotion-dev/remotion · error · Error

Unsupported platform

Error message

Unsupported platform: ${process.platform}

What it means

Thrown by `installWhisperCpu` when `process.platform` is neither 'win32', 'darwin', nor 'linux' (the only platforms for which Remotion provides or builds whisper.cpp binaries). Any other platform value falls through to this terminal error.

Solutions

1. Run the install on a supported OS: Linux, macOS, or Windows.
2. If you must use another platform, build whisper.cpp manually from source and point `transcribe` at the resulting executable path.
3. Verify with `process.platform` what Node.js reports for your environment.

const SUPPORTED = new Set(['win32', 'darwin', 'linux']);
if (!SUPPORTED.has(process.platform)) {
  throw new Error(`@remotion/install-whisper-cpp does not support platform ${process.platform}. Use Linux, macOS, or Windows.`);
}

function isSupportedPlatform(p: string): boolean {
  return p === 'win32' || p === 'darwin' || p === 'linux';
}

When it happens

Trigger: Running the install on FreeBSD, AIX, SunOS, or any other Unix variant. The function branches on platform and the final `throw` is the catch-all after the supported branches.

Common situations: Running inside an unusual container or CI image reported as an unsupported platform; a custom Node.js build with a non-standard platform string; attempting to use the package on a niche OS.

Related errors

• Whisper folder exists but the executable ( ) is missing…
• chunkLengthInSeconds must be between 1 and 30.
• Content-Length header not found
• Could not find "react-dom" package. Did you install it?
• doSample must be a boolean.

AI-assisted analysis of remotion-dev/remotion@b2f4e34732 (2026-08-12). Data as JSON: /api/errors/5ac05595ee4c6b8e. Report an issue: GitHub.

Appendix: source

Thrown at packages/install-whisper-cpp/src/install-whisper-cpp.ts:228

			version,
			to,
			printOutput,
			signal: signal ?? null,
		});
		return Promise.resolve({alreadyExisted: false});
	}

	if (process.platform === 'win32') {
		await installForWindows({
			version,
			to,
			printOutput,
			signal: signal ?? null,
		});
		return Promise.resolve({alreadyExisted: false});
	}

	throw new Error(`Unsupported platform: ${process.platform}`);
};

View on GitHub (pinned to b2f4e34732)