Disable Headless Mode

If disabled, the render will open an actual Chrome window where you can see the render happen. This requires Chrome for Testing or a custom Chrome or Chromium executable. Chrome Headless Shell always runs headlessly. The default is headless mode.

CLI flag

--disable-headless

The following CLI commands accept this option:

• remotion studio
• remotion render
• remotion still
• remotion compositions
• remotion benchmark
• remotion gpu
• remotion lambda render
• remotion lambda still
• remotion lambda compositions
• remotion cloudrun render
• remotion cloudrun still

APIs that have this option

The following APIs accept this option:

• renderFrames()
• renderMedia()
• renderStill()

Config file

remotion.config.ts

Config.setChromiumHeadlessMode(false);

See also

• All options