Skip to content

Latest commit

 

History

History
48 lines (32 loc) · 1.78 KB

README.md

File metadata and controls

48 lines (32 loc) · 1.78 KB
Raw

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 Node.js, it works on version >= 16.
  • 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 use import() 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.