123 lines
4.4 KiB
Markdown
123 lines
4.4 KiB
Markdown
# Please visit [Kagami/ffmpeg.js](https://github.com/Kagami/ffmpeg.js/) if you are looking for ffmpeg.js
|
||
|
||
|
||
<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)
|
||
|
||
Use FFmpeg directly in your browser without any backend services!!
|
||
|
||
**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 Formats
|
||
|
||
- mp4 (x264)
|
||
- webm (vp8/vp9) (^0.8.0)
|
||
- mp3 (^0.8.0)
|
||
|
||
---
|
||
|
||
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 } = require('@ffmpeg/ffmpeg');
|
||
|
||
const ffmpeg = createFFmpeg({ log: true });
|
||
|
||
(async () => {
|
||
await ffmpeg.load();
|
||
await ffmpeg.write('test.avi', './test.avi');
|
||
await ffmpeg.transcode('test.avi', 'test.mp4');
|
||
fs.writeFileSync('./test.mp4', ffmpeg.read('test.mp4'));
|
||
process.exit(0);
|
||
})();
|
||
```
|
||
|
||
## Installation
|
||
|
||
```
|
||
$ npm install @ffmpeg/ffmpeg
|
||
```
|
||
|
||
> 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.8.3/dist/ffmpeg.min.js"></script>
|
||
<script>
|
||
const { createFFmpeg } = FFmpeg;
|
||
...
|
||
</script>
|
||
```
|
||
|
||
## Multi-thread
|
||
|
||
Starting from v0.8.0, multithreading is enabled and you can use this feature by passing `-threads <NUM>` (`NUM` < 8 ). For built-in functions like `transcode()`, you can pass it as 3rd argument.
|
||
|
||
```javascript
|
||
// in transcode()
|
||
await ffmpeg.transcode('flame.avi', 'flame.mp4', '-threads 2');
|
||
|
||
// in run()
|
||
await ffmpeg.run('-i flame.avi -threads 2 flame.mp4');
|
||
```
|
||
|
||
## Examples
|
||
|
||
- With React: https://github.com/ffmpegwasm/react-app
|
||
|
||
## Documentation
|
||
|
||
- [API](https://github.com/ffmpegwasm/ffmpeg.wasm/blob/master/docs/api.md)
|
||
|
||
## Tutorials
|
||
|
||
Learn how to build ffmpeg.wasm from stories:
|
||
|
||
- [Part.1 Preparation](https://jeromewu.github.io/build-ffmpeg-webassembly-version-part-1-preparation/)
|
||
- [Part.2 Compile with Emscripten](https://jeromewu.github.io/build-ffmpeg-webassembly-version-part-2-compile-with-emscripten/)
|
||
- [Part.3 ffmpeg.wasm v0.1— Transcoding avi to mp4](https://jeromewu.github.io/build-ffmpeg-webassembly-version-part-3-v0.1/)
|
||
- [Part.4 ffmpeg.wasm v0.2 — Web Worker and Libx264](https://jeromewu.github.io/build-ffmpeg-webassembly-version-part-4-v0.2/)
|