Skip to main content

Contributing to Remotion

Issues and pull requests of all sorts are welcome!

For bigger projects, please coordinate with Jonny Burger (jonny@remotion.dev, Discord: Jonny Burger#1111) to make sure your changes get merged.

Please note that since we charge for Remotion when companies are using it, this is a commercial project.
By sending pull requests, you agree that we can use your code changes in a commercial context.

Furthermore, also note that you cannot redistribute this project. Please see LICENSE.md for what's allowed and what's not.

This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Setup

1
Remotion uses pnpm as the package manager for development in this repository. We recommend using Corepack so you get the same version of pnpm as we have.

sh
corepack enable
sh
corepack enable

If you don't have corepack, install pnpm manually:

sh
npm i -g pnpm@7.7.1
sh
npm i -g pnpm@7.7.1

Prefix with sudo if necessary.

2
Clone the Remotion repository:
sh
git clone https://github.com/remotion-dev/remotion.git && cd remotion
sh
git clone https://github.com/remotion-dev/remotion.git && cd remotion
3
Install all dependencies:
sh
pnpm i
sh
pnpm i
4
Build the project initially:
sh
pnpm build
sh
pnpm build
5
Rebuild whenever a file changes:
sh
pnpm watch
sh
pnpm watch
6
You can start making changes!

Testing your changes

You can start the Testbed using

sh
cd packages/example
pnpm start
sh
cd packages/example
pnpm start

You can render a test video using

sh
cd packages/example
pnpm render
sh
cd packages/example
pnpm render

You can run tests using

sh
pnpm test
sh
pnpm test

in either a subpackage to run tests for that package or in the root to run all tests.

Running the @remotion/player testbed

You can test changes to @remotion/player by starting the Player testbed:

sh
cd packages/player-example
pnpm start
sh
cd packages/player-example
pnpm start

For information about testing, please consult TESTING.md. Issues and pull requests of all sorts are welcome!

Running documentation

You can run the Docusaurus server that powers our docs using:

sh
cd packages/docs
pnpm start
sh
cd packages/docs
pnpm start

Troubleshooting

If your pnpm build throws errors, oftentimes it is because of caching issues. You can resolve many of these errors by running

ts
pnpm run clean
ts
pnpm run clean

in the root directory. Make sure to beforehand kill any pnpm watch commands, as those might regenerate files as you clean them!

Developing Rust parts

To develop the Rust parts of Remotion, see the README in packages/renderer/README.md

See also