Need help with node-ffmpeg-installer?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

241 Stars 33 Forks 77 Commits 11 Opened issues


Platform independent binary installer of FFmpeg for node projects

Services available


Need anything else?

Contributors list

No Data


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

Installs a binary of

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

A combination of package.json fields

, and
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');

Known issues

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.

AWS and/or Elastic Beanstalk

If you get permissions issues, try adding a .npmrc file with the following:


See issue #21

Wrong path under Electron with Asar enabled

It's a known issue that Asar breaks native paths. As a workaround, if you use Asar, you can do something like this:

const ffmpegPath = require('@ffmpeg-installer/ffmpeg').path.replace('app.asar', 'app.asar.unpacked');

The binaries

Downloaded from the sources listed at

  • Linux 32-bit: (20181210-g0e8eb07980):
  • Linux 64-bit: (20181210-g0e8eb07980):
  • Mac OS/X (92718-g092cb17983):
  • Windows 32-bit (20181217-f22fcd4):
  • Windows 64-bit (20181217-f22fcd4):

For version updates, submit issue or pull request.

Upload new versions

In every updated

npm run upload

See also

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.