ffmpeg-ffprobe
v7.1.0-rc1
Published
ffmpeg and ffprobe static binaries for Mac OSX, Linux, and Windows
Downloads
21
Maintainers
Readme
ffmpeg-ffprobe-static
Fork of ffmpeg-static that includes ffprobe.
Info
ffmpeg static binaries for Mac OSX, Linux, Windows and FreeBSD.
Supports macOS (64-bit and arm64), Linux (32 and 64-bit, armhf, arm64) and Windows (32 and 64-bit). The ffmpeg version currently used is 7.1
.
Note: The version of ffmpeg-ffprobe-static
follows SemVer. When releasing new versions, we do not consider breaking changes in ffmpeg
itself, but only the JS interface (see below). To stop ffmpeg-ffprobe-static
from breaking your code by getting updated, lock the version down or use a lockfile.
Installation
This module is installed via npm:
$ npm install ffmpeg-ffprobe-static-2
Note: During installation, it will download the appropriate ffmpeg
binary from the b7.1.0
GitHub release. Use and distribution of the binary releases of FFmpeg are covered by their respective license.
Alternatively, it will fetch binaries from FFMPEG_FFPROBE_STATIC_BASE_URL
if set as an environment variable. The default base URL is https://github.com/descriptinc/ffmpeg-ffprobe-static/releases/download/. The install script will fetch binaries from BASE_URL/binary-release-tag
(the binary-release-tag
is set in package.json and can customized by setting FFMPEG_BINARY_RELEASE
).
Electron & other cross-platform packaging tools
Because ffmpeg-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 ffmpeg binary on the local filesystem.
var pathToFfmpeg = require('ffmpeg-ffprobe-static-2');
console.log(pathToFfmpeg);
/Users/j/playground/node_modules/ffmpeg-ffprobe-static-2/ffmpeg
Check the example script for a more thorough example.
Sources of the binaries
The build script downloads binaries from these locations:
- Windows x64 builds
- Windows x86 builds
- Linux builds
- macOS builds for Intel / for ARM (Apple Silicon)
- FreeBSD builds
The build script extracts build information and (when possible) the license file from the downloaded package or the distribution server. Please consult the individual build's project site for exact source versions, which you can locate based on the version information included in the README file.
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:
- Windows builds: Jaex
- Linux builds: John Van Sickle
- macOS builds: Helmut K. C. Tessarek
Building the project
The unzip
, tar
CLI executables need to be installed. On macOS, use brew install gnu-tar xz
.