Part of the
Renders a series of images using Puppeteer and computes information for mixing audio.
remotion.config.ts and CLI flags do not apply to this function. You must pass all options explicitly.
Takes an object with the following keys:
string specifying the ID of the composition. See: Defining compositions.
A callback that fires after the setup process (validation, browser launch) has finished. Example value
A callback function that gets called whenever a frame finished rendering. An argument is passed containing how many frames have been rendered (not the frame number of the rendered frame). Example value
string specifying the directory (absolute path) to which frames should be saved.
Custom props which will be passed to the component. Useful for rendering videos with dynamic content. Can be an object of any shape.
string specifying the location of the bundled Remotion project.
string which must be either
jpegby default because it is the fastest.
pngif you want your image sequence to have an alpha channel (for transparency).
noneif you only want to render audio.
number specifying how many frames should be rendered in parallel or
null to let Remotion decide based on the CPU of the host machine. Default is half of the CPU threads available.
Sets the quality of the generated JPEG images. Must be an integer between 0 and 100. Default is to leave it up to the browser, current default is 80.
Only applies if
'jpeg', otherwise this option is invalid.
Specify a single frame (passing a
number) or a range of frames (passsing a tuple
[number, number]) to be rendered. By passing
null (default) all frames of a composition get rendered.
dumpio flag to Puppeteer which will log all browser logs to the console. Useful for debugging.
boolean flag, default is
An already open Puppeteer
Browser instance. Reusing a browser across multiple function calls can speed up the rendering process. You are responsible for opening and closing the browser yourself. If you don't specify this option, a new browser will be opened and closed at the end.
optional - Available since v2.2.0
An object containing key-value pairs of environment variables which will be injected into your Remotion projected and which can be accessed by reading the global
optional - Available since v2.1.0
Allows you to react to an exception thrown in your React code. The callback has an argument which is an object containing
frame property tells you at which frame the error was thrown. If the error was thrown at startup,
frame is null.
A promise resolving to an object containing the following properties:
number- describing how many frames got rendered.
RenderAssetInfo- information that can be passed to
stitchFramesToVideo()to mix audio. The shape of this object should be considered as Remotion internals and may change across Remotion versions.