Skip to main content

npx remotion open-timeline importv4.0.543

Imports an OpenTimelineIO (.otio) file as a new composition without starting Remotion Studio.

Import a composition
bunx remotion open-timeline import my-edit.otio

The command creates an editable composition, copies referenced local media into the public directory, and installs @remotion/media if needed. Media already in the public directory is reused. Remote media URLs are preserved.

Relative media paths are resolved from the timeline's directory.
Use --media-dir to import media from another directory.

Unsupported timeline features are printed, see supported timelines.

The command prints the files and dependencies, then imports them. Use --dry-run to preview without installing packages or writing files.

Flags​

--composition​

The new composition ID - must not be pre-existing.
If omitted, a filename is generated off your .otio file name.

--root-file​

The root file, relative to the project root. Detected automatically if not passed.

--dry-run​

Validates the input and previews the composition, source files, assets, and dependencies without installing packages or writing files.

--width​

Overrides the width of the composition.

Defaults to 1920.

--height​

Overrides the height of the composition.

Defaults to 1080.

--fps​

Overrides the frames per second of the composition.

Defaults to 30. The composition duration is calculated from the timeline at this frame rate.

--media-dir​

Directory containing the media referenced by an OpenTimelineIO file. Defaults to the directory containing the timeline. Missing absolute paths are also looked up by filename in this directory.

--binaries-directory​

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.

--public-dir​

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

--package-manager​

Forces a specific package manager to be used. By default, Remotion will auto-detect the package manager based on your lockfile.
Acceptable values are npm, yarn, pnpm, bun and nub.

See also​