ffprobe-wasm
v0.3.1
Published
ffprobe-like for browser and node, powered by WebAssembly
Downloads
2,163
Readme
ffprobe-wasm
Gather information from multimedia streams. Works on the browser and Node.js.
Uses the code at alfg/ffprobe-wasm, but in a packaged format, so it can be reused in other projects.
For limitations and recommendations, see Notes section.
Installation
npm install ffprobe-wasm
Examples
Node.js
import { FFprobeWorker } from "ffprobe-wasm";
const worker = new FFprobeWorker();
const fileInfo = await worker.getFileInfo("file.mp4");
console.log(fileInfo);
Browser
import { FFprobeWorker } from "ffprobe-wasm";
const worker = new FFprobeWorker();
// input is the reference to an <input type="file" /> element
input.addEventListener("change", (event) => {
const file = event.target.files[0];
const fileInfo = await worker.getFileInfo(file);
console.log(fileInfo);
});
Notes
- This project doesn't build or use FFprobe. Instead it uses FFmpeg's libavformat and libavcodec to output similar results. This means that not everything that FFprobe supports is bundled, so there are some containers and codecs that are not supported.
- In browser,
SharedArrayBuffer
is being used. To enable this in your server, read Security requirements. - In browser, everything is bundled in the
browser.mjs
script. When gzipped, this file is bigger than 1 MiB, so it's recommended to useimport()
to lazy load the asset. The good side of this is that you don't have to configure your bundler to include the worker or wasm files and you won't face same-origin issues with the worker.