π₯ Make videos programmatically with React
import type {LogLevel} from './log-level';
import {Log} from './logger';
import {truthy} from './truthy';
let alreadyPrintedCache: string[] = [];
export const printUsefulErrorMessage = (
err: Error,
logLevel: LogLevel,
indent: boolean,
) => {
const errorStack = (err as Error).stack;
if (errorStack && alreadyPrintedCache.includes(errorStack)) {
return;
}
if (errorStack) {
alreadyPrintedCache.push(errorStack);
alreadyPrintedCache = alreadyPrintedCache.slice(-10);
}
if (err.message.includes('Could not play video with')) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/media-playback-error',
);
}
if (
err.message.includes('A delayRender()') &&
err.message.includes('was called but not cleared after')
) {
Log.info({indent, logLevel});
if (err.message.includes('/proxy')) {
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/troubleshooting/delay-render-proxy',
);
}
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/timeout',
);
}
if (err.message.includes('Target closed')) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/target-closed',
);
}
if (err.message.includes('Timed out evaluating')) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/troubleshooting/timed-out-page-function',
);
}
if (err.message.includes('ENAMETOOLONG')) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/enametoolong',
);
}
if (
err.message.includes('Member must have value less than or equal to 3008')
) {
Log.warn({indent, logLevel});
Log.warn(
{indent, logLevel},
'π‘ This error indicates that you have a AWS account on the free or basic tier or have been limited by your organization.',
);
Log.warn(
{indent, logLevel},
'Often times this can be solved by adding a credit card, or if already done, by contacting AWS support.',
);
Log.warn(
{
indent,
logLevel,
},
'Alternatively, you can decrease the memory size of your Lambda function to a value below 3008 MB. See: https://www.remotion.dev/docs/lambda/runtime#core-count--vcpus',
);
Log.warn(
{indent, logLevel},
'See also: https://repost.aws/questions/QUKruWYNDYTSmP17jCnIz6IQ/questions/QUKruWYNDYTSmP17jCnIz6IQ/unable-to-set-lambda-memory-over-3008mb',
);
}
if (
err.stack?.includes('TooManyRequestsException: Rate Exceeded.') ||
err.message?.includes('ConcurrentInvocationLimitExceeded')
) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ This error indicates that your Lambda concurrency limit is too low. See: https://www.remotion.dev/docs/lambda/troubleshooting/rate-limit',
);
}
if (
err.message.includes('Failed to acquire WebGL2 context') ||
err.message.includes('Failed to acquire WebGL context')
) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/troubleshooting/webgl2-context',
);
}
if (err.message.includes('Error creating WebGL context')) {
Log.info({indent, logLevel});
Log.warn(
{
indent,
logLevel,
},
'π‘ You might need to set the OpenGL renderer to "angle". Learn why at https://www.remotion.dev/docs/three',
);
Log.warn(
{
indent,
logLevel,
},
"π‘ Check how it's done at https://www.remotion.dev/docs/chromium-flags#--gl",
);
Log.info(
{indent, logLevel},
'π‘ Get help for this issue at https://remotion.dev/docs/troubleshooting/webgl2-context',
);
}
if (err.message.includes('The bucket does not allow ACLs')) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ Fix for this issue: https://remotion.dev/docs/lambda/troubleshooting/bucket-disallows-acl',
);
}
if (err.message.includes('Minified React error #306')) {
const componentName = err.message.match(/<\w+>/)?.[0];
Log.info(
{indent, logLevel},
[
'π‘ This error indicates that the component',
componentName ? `(${componentName})` : null,
'you are trying to render is not imported correctly.',
]
.filter(truthy)
.join(' '),
);
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
' Check the root file and ensure that the component is not undefined.',
);
Log.info(
{indent, logLevel},
' Oftentimes, this happens if the component is missing the `export` keyword',
);
Log.info(
{indent, logLevel},
' or if the component was renamed and the import statement not properly adjusted.',
);
}
if (err.message.includes('GLIBC_')) {
Log.info({indent, logLevel}, 'π‘ Remotion requires at least Libc 2.35.');
Log.info(
{indent, logLevel},
'π‘ Get help for this issue: https://github.com/remotion-dev/remotion/issues/2439',
);
}
if (err.message.includes('AVCaptureDeviceTypeContinuityCamera')) {
Log.info(
{indent, logLevel},
'π‘ Remotion requires macOS 15 (Sequoia) or later.',
);
Log.info(
{indent, logLevel},
'π‘ Get help for this issue: https://github.com/remotion-dev/remotion/issues/7027',
);
}
if (err.message.includes('EBADF')) {
Log.info(
{indent, logLevel},
'π‘ This error might be fixed by changing your Node version:',
);
Log.info(
{indent, logLevel},
' https://github.com/remotion-dev/remotion/issues/2452',
);
}
if (err.message.includes('routines::unsupported')) {
Log.info(
{indent, logLevel},
'π‘ This error might happen if using Cloud Run with credentials that have a newline at the end or are otherwise badly encoded.',
);
Log.info(
{indent, logLevel},
' https://github.com/remotion-dev/remotion/issues/3864',
);
}
if (err.message.includes('Failed to fetch')) {
Log.info(
{indent, logLevel},
'π‘ On Lambda, one reason this could happen is that Chrome is rejecting an asset to be loaded when it is running low on disk space.',
);
Log.info(
{indent, logLevel},
'Try increasing the disk size of your Lambda function.',
);
}
if (err.message.includes('Invalid value specified for cpu')) {
Log.info({indent, logLevel});
Log.info(
{indent, logLevel},
'π‘ This error indicates that your GCP account does have a limit. Try setting `--maxInstances=5` / `maxInstances: 5` when deploying this service.',
);
Log.info({
indent,
logLevel,
});
}
};