Files
mediabunny/packages/prores/README.md
T

2.3 KiB

@mediabunny/prores

Browsers have no support for Apple ProRes in their WebCodecs implementations. This extension package provides a decoder for use with Mediabunny, allowing you to decode ProRes directly in the browser at unprecedented speed. It is implemented using Mediabunny's custom coder API and uses TurboRes, an extremely fast WASM-based ProRes decoder, under the hood.

This package, like the rest of Mediabunny, is enabled by its sponsors and their donations. If you've derived value from this package, please consider leaving a donation! 💘

Installation

This library peer-depends on Mediabunny. Install both using npm:

npm install mediabunny @mediabunny/prores

Alternatively, directly include them using a script tag:

<script src="mediabunny.js"></script>
<script src="mediabunny-prores.js"></script>

This will expose the global objects Mediabunny and MediabunnyProres. Use mediabunny-prores.d.ts to provide types for these globals. You can download the built distribution files from the releases page.

Usage

import { registerProresDecoder } from '@mediabunny/prores';

registerProresDecoder();

That's it - Mediabunny now uses the registered ProRes decoder automatically.

For all the ways of using Mediabunny, refer to its guide.

Building and development

The complete JavaScript package can be built alongside the rest of Mediabunny by running npm run build in Mediabunny's root.