Convert a video
You can convert a video in the browser from one format to another using the convertMedia() function from @remotion/webcodecs.
💼 Important License Disclaimer
This package is licensed under the Remotion License.
We consider a team of 4 or more people a "company".
We consider a team of 4 or more people a "company".
For "companies": A Remotion Company license needs to be obtained to use this package.
In a future version of
In a future version of
@remotion/webcodecs, this package will also require the purchase of a newly created "WebCodecs Conversion Seat". Get in touch with us if you are planning to use this package.For individuals and teams up to 3: You can use this package for free.
This is a short, non-binding explanation of our license. See the License itself for more details.
The following input formats are supported:
- ISO Base Media (
.mp4,.mov,.m4a) - Matroska (
.mkv,.webm) .avi- MPEG Transport Stream (
.ts) .wav,.mp3.flac.aac- HLS (
.m3u8)
The following output formats are supported:
- MP4
- WebM
- WAV
The following output video codecs are supported:
- VP8 (WebM only)
- VP9 (WebM only)
- H.264 (MP4 only)
The following output audio codecs are supported:
- Opus (WebM only)
- AAC (MP4 only)
- PCM (WAV only)
Installation​
Install the @remotion/webcodecs and @remotion/media-parser packages:
- Remotion CLI
- npm
- bun
- pnpm
- yarn
npx remotion add @remotion/webcodecs @remotion/media-parser
This assumes you are currently using v4.0.545 of Remotion.npm i --save-exact @remotion/[email protected] @remotion/[email protected]
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.545 of Remotion.pnpm i @remotion/[email protected] @remotion/[email protected]
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.545 of Remotion.bun i @remotion/[email protected] @remotion/[email protected]
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.545 of Remotion.yarn --exact add @remotion/[email protected] @remotion/[email protected]
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.Basic conversions​
Converting from an URL​
(needs to be CORS-enabled)
Converting an MP4 to a WebMimport {convertMedia } from '@remotion/webcodecs'; constresult = awaitconvertMedia ({src : 'https://remotion.media/BigBuckBunny.mp4',container : 'webm', }); constblob = awaitresult .save ();
Converting from a File:​
Converting a fileimport {convertMedia } from '@remotion/webcodecs'; // Get an actual file from an <input type="file"> element constfile = newFile ([], 'video.mp4'); constresult = awaitconvertMedia ({src :file ,container : 'webm', }); constblob = awaitresult .save ();
Specifying the output codec​
You can specify the output codec by passing the videoCodec and audioCodec options:
Converting to VP9import {convertMedia } from '@remotion/webcodecs'; constresult = awaitconvertMedia ({src : 'https://remotion.media/BigBuckBunny.mp4',container : 'webm',videoCodec : 'vp9',audioCodec : 'opus', }); constblob = awaitresult .save ();
Saving the converted video​
The convertMedia() function returns a result object with a save() method that you need to call to get the converted video as a Blob.
Download the converted video​
Download converted videoimport {convertMedia } from '@remotion/webcodecs'; constresult = awaitconvertMedia ({src : 'https://remotion.media/BigBuckBunny.mp4',container : 'webm', }); constblob = awaitresult .save (); // Create download link consturl =URL .createObjectURL (blob ); constlink =document .createElement ('a');link .href =url ;link .download = 'converted-video.webm';document .body .appendChild (link );link .click ();document .body .removeChild (link );URL .revokeObjectURL (url );
Upload the converted video​
Upload converted videoimport {convertMedia } from '@remotion/webcodecs'; constresult = awaitconvertMedia ({src : 'https://remotion.media/BigBuckBunny.mp4',container : 'webm', }); constblob = awaitresult .save (); // Upload to server constformData = newFormData ();formData .append ('video',blob , 'converted-video.webm'); awaitfetch ('/api/upload', {method : 'POST',body :formData , });
Display the converted video​
Display converted videoimport {convertMedia } from '@remotion/webcodecs'; constresult = awaitconvertMedia ({src : 'https://remotion.media/BigBuckBunny.mp4',container : 'webm', }); constblob = awaitresult .save (); // Display in video element consturl =URL .createObjectURL (blob ); constvideo =document .createElement ('video');video .src =url ;video .controls = true;document .body .appendChild (video ); // Don't forget to clean up when done // URL.revokeObjectURL(url);
Advanced conversions​
See Track Transformation for how you can get more control over the conversion.