Remotion Studio Protocolv4.0.502
A versioned protocol for connecting websites to Remotion Studio.
Protocol v1 supports Remotion Elements from the official Remotion Elements library. It provides one Element payload that can be delivered by dragging it into Studio or by requesting installation into the active composition.
- Remotion CLI
- npm
- bun
- pnpm
- yarn
npx remotion add @remotion/studio-protocol
This assumes you are currently using v4.0.504 of Remotion.npm i --save-exact @remotion/studio-protocol@4.0.504
Also update
remotion and all `@remotion/*` packages to the same version.Remove all
^ character in front of the version numbers of it as it can lead to a version conflict.This assumes you are currently using v4.0.504 of Remotion.pnpm i @remotion/studio-protocol@4.0.504
Also update
remotion and all `@remotion/*` packages to the same version.Remove all
^ character in front of the version numbers of it as it can lead to a version conflict.This assumes you are currently using v4.0.504 of Remotion.bun i @remotion/studio-protocol@4.0.504
Also update
remotion and all `@remotion/*` packages to the same version.Remove all
^ character in front of the version numbers of it as it can lead to a version conflict.This assumes you are currently using v4.0.504 of Remotion.yarn --exact add @remotion/studio-protocol@4.0.504
Also update
remotion and all `@remotion/*` packages to the same version.Remove all
^ character in front of the version numbers of it as it can lead to a version conflict.Usage
element.tsimport {createElementPayload ,installInStudio , } from '@remotion/studio-protocol'; constpayload =createElementPayload ({displayName : 'Lower Third',slug : 'lower-third',sourceCode : 'export const LowerThird = () => null;',dependencies : [],dimensions : {width : 900,height : 260},durationInFrames : 90, }); constresult = awaitinstallInStudio ({payload }); if (result .success ) {console .log (result .status ); // "awaiting-confirmation" }
A successful request means Studio received the Element and is awaiting confirmation. It does not mean dependencies or source files were installed.
APIs
createElementPayload()
Create a versioned Element payload
setStudioDragData()
Put an Element payload on a drag event
installInStudio()
Request installation into the active Studio
Security
Confirmation and origin policy
Supported origins
Any HTTPS website can request an Element installation confirmation. HTTP is supported on localhost and 127.0.0.1 for local development.
Compatibility
Remotion Studio 4.0.502 or newer is required. Browser Studio is not supported in protocol v1.