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).
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.
Terminalnpx 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.
Terminalnpx remotion studio --editor=cursor
--coding-agentv4.0.506
Set the default coding agent for Remotion Studio. Available coding agents: codex, cursor, copilot, claude-code.
Terminalnpx 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:
BROWSERbehaves like the--browserflag.BROWSER_ARGSbehaves like the--browser-argsflag.- Setting
BROWSER=nonedisables 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.
Terminalnpx 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.
Terminalnpx remotion studio --show-layer-frame-numbers
--show-premountingv4.0.535
Show premounting indicators in the Studio timeline. Defaults to false.
Terminalnpx 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
We are currently testing this prop. We might either remove the functionality or rename the prop to a stable name.
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 previewingnpx 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.
--chromium-blink-featuresv4.0.543
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.