node package manager
Easy sharing. Manage teams and permissions with one click. Create a free org »



Platform independent binary installer of FFmpeg for node projects. Useful for tools that should "just work" on multiple environments.

Installs a binary of ffmpeg for the current platform and provides a path and version. Supports Linux, Windows and Mac OS/X.

A combination of package.json fields optionalDependencies, cpu, and os let's the installer only download the binary for the current platform. See also "Warnings during install", below.


npm install --save @ffmpeg-installer/ffmpeg

Usage examples

const ffmpeg = require('@ffmpeg-installer/ffmpeg');
console.log(ffmpeg.path, ffmpeg.version);


const ffmpegPath = require('@ffmpeg-installer/ffmpeg').path;
const spawn = require('child_process').spawn;
const ffmpeg = spawn(ffmpegPath, args);
ffmpeg.on('exit', onExit);


const ffmpegPath = require('@ffmpeg-installer/ffmpeg').path;
const ffmpeg = require('fluent-ffmpeg');

Warnings during install

To automatically choose the binary to install, optionalDependencies are used. This currently outputs warnings in the console, an issue that is tracked by the npm team here.

The binaries

Downloaded from the sources listed at

For version updates, submit issue or pull request.

Upload new versions

In every updated platforms/* directory:

npm run upload

See also