ext/hyperframes
2
0
Fork 0
mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-05 00:56:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix(render): diagnose unlaunchable Windows FFmpeg (#2430)

Browse Source
This commit is contained in:
Miguel Ángel
2026-07-14 12:55:46 -04:00
committed by GitHub
parent fb0d823500
commit 3d7e26aabf
4 changed files with 84 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/engine/src/utils/runFfmpeg.test.ts
+17
View File
@@ -6,9 +6,12 @@ import { formatFfmpegError } from "./runFfmpeg.js";
describe("formatFfmpegError", () => {
const originalPlatform = process.platform;
const originalFfmpegPath = process.env.HYPERFRAMES_FFMPEG_PATH;
afterEach(() => {
Object.defineProperty(process, "platform", { value: originalPlatform, configurable: true });
if (originalFfmpegPath === undefined) delete process.env.HYPERFRAMES_FFMPEG_PATH;
else process.env.HYPERFRAMES_FFMPEG_PATH = originalFfmpegPath;
});
it("reports exit code alone when stderr is empty", () => {
@@ -57,6 +60,20 @@ describe("formatFfmpegError", () => {
expect(formatFfmpegError(3221225595, "")).toContain("wrong architecture");
});
it.each([3221225781, -1073741515])(
"maps Windows DLL-not-found exit code %s to selected-path guidance",
(exitCode) => {
Object.defineProperty(process, "platform", { value: "win32", configurable: true });
process.env.HYPERFRAMES_FFMPEG_PATH = "/tools/ffmpeg.exe";
const message = formatFfmpegError(exitCode, "");
expect(message).toContain("0xC0000135 (STATUS_DLL_NOT_FOUND)");
expect(message).toContain("/tools/ffmpeg.exe");
expect(message).toContain("working 64-bit Windows FFmpeg build");
},
);
});
function createSpawnSpy() {
packages/engine/src/utils/runFfmpeg.ts
+8
View File
@@ -29,6 +29,14 @@ const DEFAULT_STDERR_TAIL_LINES = 15;
function formatWindowsFfmpegExit(exitCode: number | null): string | undefined {
if (process.platform !== "win32" || exitCode === null) return undefined;
if (exitCode === 3221225781 || exitCode === -1073741515) {
const ffmpegPath = getFfmpegBinary();
return (
`[FFmpeg] Windows could not start "${ffmpegPath}": ` +
"0xC0000135 (STATUS_DLL_NOT_FOUND). A required DLL could not be loaded. " +
"Install a working 64-bit Windows FFmpeg build with all required runtime DLLs."
);
}
if (exitCode === 3221225595 || exitCode === -1073741701) {
return (
"[FFmpeg] Windows could not start ffmpeg.exe (STATUS_INVALID_IMAGE_FORMAT). " +