Skip to main content

npx remotion studio

Alias: npx remotion preview

Start the Remotion Studio.

npx remotion studio <entry-point>?

You may pass an entry point as an argument, otherwise it will be determined.

Reopen the Studiov4.0.487​

While npx remotion studio is running, press s in the terminal to reopen the Studio in your browser.

Flags​

--props​

Input Props to pass to the selected composition of your video. Must be a serialized JSON string (--props='{"hello": "world"}') or a path to a JSON file (./path/to/props.json).
note

Inline JSON string isn't supported on Windows shells because it removes the " character, use a file name instead.

--configv1.2.0​

Specify a location for the Remotion config file.

--env-filev2.2.0​

Specify a location for a dotenv file. Default .env.

--log​

One of trace, verbose, info, warn, error.
Determines how much info is being logged to the console.

Default info.

--port​

Set a custom HTTP server port for the Studio or the render process. If not defined, Remotion will try to find a free port.

--public-dirv3.2.13​

Define the location of the public/ directory. If not defined, Remotion will assume the location is the public folder in your Remotion root.

--disable-keyboard-shortcutsv3.2.11​

Enable or disable keyboard shortcuts in the Remotion Studio.

--disable-canvas-tabsv4.0.530​

Enable or disable the tabs above the Studio canvas.

--high-contrastv4.0.542​

Increase the contrast of text, focus indicators, and panel dividers in Remotion Studio. Defaults to false. You can toggle it in Settings → Studio → Interface while Studio is running.
Terminal
npx remotion studio --high-contrast

--disable-interactivityv4.0.487​

Enable or disable interactive editing in the Remotion Studio. When disabled, the Studio keeps previewing and source navigation available, but disables preview outlines, the sequence inspector, visual controls, timeline selection and timeline editing gestures.

--sequence-activity-limitv4.0.536​

Limit hidden scenes discovered by Sequence Activity in the Remotion Studio, including nested sequences and their ancestors. Visible, premounted, and postmounted scenes always render. Defaults to Infinity for unlimited discovery without admission delays. Must be a non-negative safe integer or Infinity. Set to 0 to disable Sequence Activity. Finite limits prioritize nearby scenes. Does not affect rendering.

--allow-html-in-canvasv4.0.447​

When client-side rendering is enabled in the Studio, allow the experimental Chromium HTML-in-canvas API to be used for capturing frames. See HTML-in-canvas docs.

--editorv4.0.503​

Set the default editor for opening files from Remotion Studio. Available editors: vscode, cursor, windsurf, zed, vscodium, webstorm, sublime-text.
Terminal
npx remotion studio --editor=cursor

--coding-agentv4.0.506​

Set the default coding agent for Remotion Studio. Available coding agents: codex, cursor, copilot, claude-code.
Terminal
npx remotion studio --coding-agent=codex

--rspackv4.0.502​

Uses Rspack instead of Webpack as the bundler for the Studio or bundle.

--webpack-pollv3.3.11​

Enables Webpack polling instead of the file system event listeners for hot reloading. This is useful if you are inside a virtual machine or have a remote file system. Pass a value in milliseconds.

--no-openv3.3.19​

If specified, Remotion will not open a browser window when starting the Studio.

--browserv3.3.79​

Specify the browser which should be used for opening a tab. If not set, the system default browser is used. Pass an absolute path or "chrome" to use Chrome. If Chrome is selected as the browser and you are on macOS, Remotion will try to reuse an existing tab.

You can also configure the browser via environment variables for backwards compatibility:

  • BROWSER behaves like the --browser flag.
  • BROWSER_ARGS behaves like the --browser-args flag.
  • Setting BROWSER=none disables auto-opening of the browser (equivalent to --no-open).

--browser-argsv3.3.79​

A set of command line flags that should be passed to the browser. Pass them like this:

npx remotion studio --browser-args="--disable-web-security"

--beep-on-finishv4.0.84​

Plays a beep sound when the video is finished rendering. This is useful if you are rendering a video in the background and want to be notified when it is finished.

npx remotion studio --beep-on-finish

--ipv4v4.0.125​

Forces Remotion to bind to an IPv4 interface for the Studio server.
npx remotion studio --ipv4

--default-premount-in-secondsv4.0.535​

Set the default premount duration in seconds for timed components in the Studio. Defaults to 2. Before v4.0.535, there was no premounting by default.
Terminal
npx remotion studio --default-premount-in-seconds=2

--show-layer-frame-numbersv4.0.535​

Show the current frame number inside sequence layers in the Studio timeline. Defaults to false.
Terminal
npx remotion studio --show-layer-frame-numbers

--show-premountingv4.0.535​

Show premounting indicators in the Studio timeline. Defaults to false.
Terminal
npx remotion studio --show-premounting=false

--number-of-shared-audio-tagsv3.3.2​

Set number of shared audio tags. See Using the numberOfSharedAudioTags prop for more information.
npx remotion studio --number-of-shared-audio-tags=5

--experimental-keep-audio-context-alivev4.0.508​

EXPERIMENTAL

We are currently testing this prop. We might either remove the functionality or rename the prop to a stable name.

Keeps the shared AudioContext running while the Remotion Studio is paused.
npx remotion studio --experimental-keep-audio-context-alive

--audio-latency-hintv4.0.303​

Sets the audio latency hint for the global AudioContext that Remotion uses to play audio.
Possible values: interactive, balanced, playback
npx remotion studio --audio-latency-hint=playback

--preview-sample-ratev4.0.470​

Controls the sample rate used for audio playback during preview. When unset, Remotion uses 48000 Hz.
npx remotion studio --preview-sample-rate=44100

--cross-site-isolationv4.0.306​

Enable Cross-Site Isolation in the Studio.

npx remotion studio --cross-site-isolation

--disable-ask-aiv4.0.407​

Disable the Ask AI modal in the Studio.

npx remotion studio --disable-ask-ai

--force-newv4.0.421​

Forces starting a new Studio instance even if one is already running on the same port for the same project.
npx remotion studio --force-new

--public-license-keyv4.0.398​

The public license key for your company license, obtained from the License keys page for your project in the Remotion Dashboard. If you are eligible for the free license, pass "free-license".
npx remotion studio --public-license-key="your-license-key"

--preserve-pitch-on-playbackv4.0.538​

Preserve audio pitch when changing the Studio playback speed. Defaults to true. Applies to <Audio> and <Video> from @remotion/media, independently of their clip-level preservePitch props. Does not affect rendered output or native media components, including native fallbacks. Set --preserve-pitch-on-playback=false to disable.
Disable pitch preservation while previewing
npx remotion studio --preserve-pitch-on-playback=false

--preferred-effect-backendv4.0.540​

Prefer webgpu, webgl2, or 2d implementations of effects. Default: auto, which tries WebGPU, WebGL2, then 2D. Falls back when an implementation or backend is unavailable. Lambda selects WebGL2 or 2D implementations. Rendering fails if an effect has no supported implementation. This option also applies to Studio preview.

--chromium-flagsv4.0.543​

Adds, replaces, or removes Chrome flags. Keys omit the leading --. true adds a bare flag, a string sets its value, and false removes it. Overrides take precedence over other Chromium options. The user-data-dir and remote-debugging-* flags are reserved. Defaults to {}. Remotion’s default Chrome flags and enabled or disabled features may change between patch versions. There is no guarantee that these defaults remain unchanged.

--chromium-featuresv4.0.543​

Overrides individual Chrome features. true enables a feature and removes it from the disabled list; false disables it and removes it from the enabled list. Unspecified features retain their defaults. Applied after raw flag overrides. Defaults to {}. Remotion’s default Chrome flags and enabled or disabled features may change between patch versions. There is no guarantee that these defaults remain unchanged. Overrides individual Blink features. true enables a feature and removes it from the disabled list; false disables it and removes it from the enabled list. Unspecified features retain their defaults. Applied after raw flag overrides. Defaults to {}. Remotion’s default Chrome flags and enabled or disabled features may change between patch versions. There is no guarantee that these defaults remain unchanged.

--prores-bits-per-macroblockv4.0.543​

Set the bit budget per macroblock for software ProRes encoding. Accepts an integer from 128 to 8192. Lower values can reduce file size and quality; higher values may produce the same output depending on the content and ProRes profile. Default: null, which lets the encoder choose based on the profile. This maps to FFmpeg's -bits_per_mb option for prores_ks and requires the prores codec. With hardwareAcceleration set to if-possible, encoding falls back to software; required is not supported. The ProRes profile and pixel format still determine the output format and alpha channel support.

--show-diagnosticsv4.0.543​

Show a movable diagnostics window in the Studio with the number of audio iterators created, open Mediabunny sinks, buffering handles created, and buffering states triggered. Creation counts reset when the page reloads. The buffering handle count can also be reset in the window. While open, the window records buffering events with their contributing handles and lets you reveal the owning layers in the timeline. Setting this option on the command line disables the corresponding Studio settings switch. Defaults to false.

--binaries-directoryv4.0.120​

The directory where the platform-specific binaries and libraries that Remotion needs are located. Those include an ffmpeg and ffprobe binary, a Rust binary for various tasks, and various shared libraries. If the value is set to null, which is the default, then the path of a platform-specific package located at node_modules/@remotion/compositor-* is selected.
This option is useful in environments where Remotion is not officially supported to run like bundled serverless functions or Electron.

--disable-git-sourcev4.0.182​

Disables the Git Source being connected to the Remotion Studio. Clicking on stack traces and certain menu items will be disabled.