remotion-dev/remotion · error · Error

Unsupported platform: ${process.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.

Source

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

			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 78fe4bb3fd)

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 ${to} exists but the executable (${getWhisper
• Could not find "react-dom" package. Did you install it?
• Unsupported OS: ${process.platform}, architecture: ${process
• Invalid whisper model ${model}. Available: ${models.join(',
• Model ${model} already exists at ${filePath}, but the size i

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