ffprobe-node

ffprobe-static

Static ffprobe (from the ffmpeg project) binaries for macOS, Linux, Windows.

Supports macOS (64-bit and arm64), Linux (32 and 64-bit, armhf, arm64), Windows (32 and 64-bit). The ffmpeg version currently used is 6.0.

Note: The version of ffprobe-static follows SemVer. When releasing new versions, we do not consider breaking changes in ffprobe itself, but only the JS interface (see below). For example, ffprobe-static@4.5.0 might download ffprobe 5.0. To prevent an ffprobe-static upgrade downloading backwards-incompatible ffprobe versions, use a strict version range for it or use a lockfile.

Installation

$ npm install ffprobe-static

Note: During installation, it will download the appropriate ffprobe binary from the b6.0 GitHub release. Use and distribution of the binary releases of ffprobe are covered by their respective license.

Custom binaries url

By default, the ffprobe binary will get downloaded from https://github.com/eugeneware/ffprobe-static/releases/download. To customise this, e.g. when using a mirror, set the FFPROBE_BINARIES_URL environment variable.

export FFPROBE_BINARIES_URL=https://cdn.npmmirror.com/binaries/ffprobe-static
npm install ffprobe-static

Electron & other cross-platform packaging tools

Because ffprobe-static will download a binary specific to the OS/platform, you need to purge node_modules before (re-)packaging your app for a different OS/platform (read more in #35).

Example Usage

Returns the path of a statically linked ffprobe binary on the local filesystem.

const pathToFfprobe = require('ffprobe-static');
console.log(pathToFfprobe)
// /Users/j/playground/node_modules/ffprobe-static/ffprobe

Check the example script for a more thorough example.

Sources of the binaries

The binaries downloaded by ffprobe-static are from these locations:

• Windows x64 builds
• Windows x86 builds
• Linux x64/x86/ARM/ARM64 builds
• macOS x64 (Intel) & ARM64 (Apple Silicon) builds

Show your support

This npm package includes statically linked binaries that are produced by the following individuals. Please consider supporting and donating to them who have been providing quality binary builds for many years:

• Linux builds: John Van Sickle
• macOS builds: Helmut K. C. Tessarek