106 lines
3.9 KiB
Markdown
106 lines
3.9 KiB
Markdown
<p align="center">
|
|
<a href="#">
|
|
<img alt="ffmpeg.wasm" width="128px" height="128px" src="https://github.com/ffmpegwasm/ffmpeg.wasm/raw/master/docs/images/ffmpegwasm-icon.png">
|
|
</a>
|
|
</p>
|
|
|
|
# ffmpeg.wasm
|
|
|
|
[](https://img.shields.io/node/v/@ffmpeg/ffmpeg.svg)
|
|
[](https://github.com/ffmpegwasm/ffmpeg.wasm/actions)
|
|
|
|
|
|
[](https://github.com/ffmpegwasm/ffmpeg.wasm/graphs/commit-activity)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://github.com/airbnb/javascript)
|
|
[](https://www.npmjs.com/package/@ffmpeg/ffmpeg)
|
|
[](https://www.npmjs.com/package/@ffmpeg/ffmpeg)
|
|
|
|
ffmpeg.wasm is a pure Webassembly / Javascript port of FFmpeg. It enables video & audio record, convert and stream right inside browsers.
|
|
|
|
**Transcode**
|
|
<p align="center">
|
|
<a href="#">
|
|
<img alt="transcode-demo" src="https://github.com/ffmpegwasm/ffmpeg.wasm/raw/master/docs/images/transcode.gif">
|
|
</a>
|
|
</p>
|
|
|
|
<a href="https://codepen.io/jeromewu/pen/NWWaMeY" target="_blank">
|
|
<img alt="codepen" width="128px" src="https://blog.codepen.io/wp-content/uploads/2012/06/codepen-wordmark-display-inside-black@10x.png">
|
|
</a>
|
|
|
|
[Source Code](https://github.com/ffmpegwasm/ffmpeg.wasm/blob/master/examples/browser/transcode.html)
|
|
|
|
## Browsers support
|
|
|
|
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br/>Chrome |
|
|
| --------- |
|
|
| last 2 versions
|
|
|
|
## Examples:
|
|
|
|
| Name | Demo | Source Code |
|
|
| ---- | ------- | ----------- |
|
|
| Webcam | <a href="https://codepen.io/jeromewu/pen/qBBKzyW" target="_blank"><img alt="codepen" width="128px" src="https://blog.codepen.io/wp-content/uploads/2012/06/codepen-wordmark-display-inside-black@10x.png"></a> | [Link](https://github.com/ffmpegwasm/ffmpeg.wasm/blob/master/examples/browser/webcam.html) |
|
|
|
|
## Supported External Libraries
|
|
|
|
Check [HERE](https://github.com/ffmpegwasm/ffmpeg.wasm-core#configuration)
|
|
|
|
## Installation
|
|
|
|
```
|
|
$ npm install @ffmpeg/ffmpeg @ffmpeg/core
|
|
```
|
|
|
|
> As we are using the latest experimental features, you need to add few flags to run in Node.js
|
|
|
|
```
|
|
$ node --experimental-wasm-threads --experimental-wasm-bulk-memory transcode.js
|
|
```
|
|
|
|
Or, using a script tag in the browser (only works in Chrome):
|
|
|
|
```html
|
|
<script src="https://unpkg.com/@ffmpeg/ffmpeg@0.9.1/dist/ffmpeg.min.js"></script>
|
|
<script>
|
|
const { createFFmpeg } = FFmpeg;
|
|
...
|
|
</script>
|
|
```
|
|
|
|
## Usage
|
|
|
|
ffmpeg.wasm provides simple to use APIs, to transcode a video you only need few lines of code:
|
|
|
|
```javascript
|
|
const fs = require('fs');
|
|
const { createFFmpeg, fetchFile } = require('@ffmpeg/ffmpeg');
|
|
|
|
const ffmpeg = createFFmpeg({ log: true });
|
|
|
|
(async () => {
|
|
await ffmpeg.load();
|
|
ffmpeg.FS('writeFile', 'test.avi', await fetchFile('./test.avi'));
|
|
await ffmpeg.run('-i', 'test.avi', 'test.mp4');
|
|
fs.writeFileSync('./test.mp4', ffmpeg.FS('readFile', 'test.mp4'));
|
|
process.exit(0);
|
|
})();
|
|
```
|
|
|
|
## Multi-threading
|
|
|
|
Multi-threading need to be configured per external libraries, only following libraries supports it now:
|
|
|
|
### x264
|
|
|
|
Run it multi-threading mode by default, no need to pass any arguments.
|
|
|
|
### libvpx / webm
|
|
|
|
Need to pass `-row-mt 1`, but can only use one thread to help, can speed up around 30%
|
|
|
|
## Documentation
|
|
|
|
- [API](https://github.com/ffmpegwasm/ffmpeg.wasm/blob/master/docs/api.md)
|