kribblo/node-ffmpeg-installer


Platform independent binary installer of FFmpeg for node projects

https://www.npmjs.com/package/@ffmpeg-installer/ffmpeg

Language: JavaScript

Keywords: darwin, ffmpeg, ffmpeg-prebuilt, linux, nodejs, windows


node-ffmpeg-installer

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.

Install

npm install --save @ffmpeg-installer/ffmpeg

Usage examples

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

process.spawn()

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

fluent-ffmpeg

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

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:

unsafe-perm=true

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 ffmpeg.org:

For version updates, submit issue or pull request.

Upload new versions

In every updated platforms/* directory:

npm run upload

See also

Project Statistics

Sourcerank 12
Repository Size 317 MB
Stars 176
Forks 22
Watchers 4
Open issues 7
Dependencies 1
Contributors 3
Tags 0
Created
Last updated
Last pushed

Top Contributors See all

Kristoffer Lundén Seba Kerckhof Luis Antonio González Martín

Packages Referencing this Repo

@ffmpeg-installer/ffmpeg
Platform independent binary installer of FFmpeg for node projects
Latest release 1.0.20 - Updated - 176 stars
lapanoid-ffmpeg-installer-ffmpeg
Platform independent binary installer of FFmpeg for node projects
Latest release 1.0.15 - Published - 176 stars
@auto-tel/ffmpeg
Platform independent binary installer of FFmpeg for node projects
Latest release 1.0.16 - Published - 176 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-09-12 02:56:30 UTC

Login to resync this repository