Revideo

Create Videos with Code

Video
redotvideo/revideore.video@revideo/core

README

Revideo - Create Videos with Code


Revideo is an open source framework for programmatic video editing. It is forked
from the amazing Motion Canvas editor, with the goal
of turning it from a standalone application into a library that developers can
use to build entire video editing apps.

Revideo lets you create video templates in Typescript and deploy an API endpoint
to render them with dynamic inputs. It also provides a React player component to
preview changes in the browser in real-time. If you want to learn more, you can
check out our docs, our
examples repository, and join
our Discord server.

News 🔥


- [05/21/2024] We released an
  example
  on how to parallelize rendering jobs with Google Cloud Functions
- [05/20/2024] We have a new website!

Getting Started


To create an example project, run the following command:

  1. ```bash
  2. npm init @revideo@latest
  3. ```

The example project will have the following code, which defines the video shown
below.

  1. ```tsx
  2. import {Audio, Img, Video, makeScene2D} from '@revideo/2d';
  3. import {all, chain, createRef, waitFor} from '@revideo/core';

  5. export default makeScene2D(function* (view) {
  6.   const logoRef = createRef<Img>();

  8.   yield view.add(
  9.     <>
  10.       <Video
  11.         src={'https://revideo-example-assets.s3.amazonaws.com/stars.mp4'}
  12.         size={['100%', '100%']}
  13.         play={true}
  14.       />
  15.       <Audio
  16.         src={'https://revideo-example-assets.s3.amazonaws.com/chill-beat.mp3'}
  17.         play={true}
  18.         time={17.0}
  19.       />
  20.     </>,
  21.   );

  23.   yield* waitFor(1);

  25.   view.add(
  26.     <Img
  27.       width={'1%'}
  28.       ref={logoRef}
  29.       src={
  30.         'https://revideo-example-assets.s3.amazonaws.com/revideo-logo-white.png'
  31.       }
  32.     />,
  33.   );

  35.   yield* chain(
  36.     all(logoRef().scale(40, 2), logoRef().rotation(360, 2)),
  37.     logoRef().scale(60, 1),
  38.   );
  39. });
  40. ```

Differences between Revideo and Motion Canvas


Motion Canvas aims to be a
standalone editor for
animations. While it happens to be distributed as an npm package, the
maintainers don't intend for it to be used as a library.

We started out as users of Motion Canvas ourselves but ran into these
limitations when we wanted to build a video editing app on top of it. After
building our initial version using Motion Canvas' plugin system, we realized
that we wanted to make more fundamental changes to the codebase that would be
difficult to implement while keeping compatibility with the existing Motion
Canvas API.

That's why we decided to fork the project and turn it into Revideo. We wrote a
bit more about it on our blog.

Concretely, some of the differences to Motion Canvas are the following ones:

- Headless Rendering: Motion Canvas currently requires you to press a button
  in its UI to render a video. We have exposed this functionality as a
  function call and are making it
  possible to deploy a rendering API to services like Google Cloud Run
  (example,
  or to use our CLI to expose a rendering endpoint from your Revideo project
  (docs)
- Faster Rendering: When building an app rather than creating videos for
  yourself, rendering speeds are quite important. We have sped up rendering
  speeds by enabling
  parallelized rendering and
  replacing the seek() operation for HTML video with our ffmpeg-based
  video frame extractor
- **Better Audio Support:** We have enabled audio export from `