# @ffprobe-installer/ffprobe > Platform independent binary installer of FFprobe for node projects Latest version **2.1.2** (published 2023-08-25) · LGPL-2.1 license · 0 weekly downloads ## Install ```sh npm install @ffprobe-installer/ffprobe pnpm add @ffprobe-installer/ffprobe yarn add @ffprobe-installer/ffprobe bun add @ffprobe-installer/ffprobe ``` ## Health **Score 25/100 (F)** — status: abandoned. Positive: has types; no vulnerabilities; high quality score. Warnings: low downloads; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 2.1.2 | | Published | 2023-08-25 | | First published | 2016-09-19 | | Weekly downloads | 0 | | License | LGPL-2.1 | | TypeScript types | bundled | | Module format | CommonJS | | Node | >=14.21.2 | | Dependencies | 8 | | Unpacked size | 10 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 74 | | Author | Oliver Sayers | | Maintainers | savagecore, elppin, kikobeats | | Keywords | ffprobe, binary | ## Links - npm: https://www.npmjs.com/package/@ffprobe-installer/ffprobe - Repository: https://github.com/SavageCore/node-ffprobe-installer - Homepage: https://github.com/SavageCore/node-ffprobe-installer#readme - Issues: https://github.com/SavageCore/node-ffprobe-installer/issues - npm.io page: https://npm.io/package/@ffprobe-installer/ffprobe ## Dependencies (8) - [@ffprobe-installer/linux-arm](https://npm.io/package/@ffprobe-installer/linux-arm.md) 5.2.0 - [@ffprobe-installer/linux-x64](https://npm.io/package/@ffprobe-installer/linux-x64.md) 5.2.0 - [@ffprobe-installer/win32-x64](https://npm.io/package/@ffprobe-installer/win32-x64.md) 5.1.0 - [@ffprobe-installer/darwin-x64](https://npm.io/package/@ffprobe-installer/darwin-x64.md) 5.1.0 - [@ffprobe-installer/linux-ia32](https://npm.io/package/@ffprobe-installer/linux-ia32.md) 5.2.0 - [@ffprobe-installer/win32-ia32](https://npm.io/package/@ffprobe-installer/win32-ia32.md) 5.1.0 - [@ffprobe-installer/linux-arm64](https://npm.io/package/@ffprobe-installer/linux-arm64.md) 5.2.0 - [@ffprobe-installer/darwin-arm64](https://npm.io/package/@ffprobe-installer/darwin-arm64.md) 5.0.1 ## Recent versions - 2.1.2 (latest) — 2023-08-25 - 2.1.1 — 2023-07-13 - 2.1.0 — 2023-07-02 - 2.0.0 — 2023-02-15 - 1.4.2 — 2023-02-14 - 1.4.1 — 2022-01-11 - 1.4.0 — 2022-01-10 - 1.3.0 — 2021-12-13 - 1.2.0 — 2021-08-04 - 1.1.0 — 2020-08-24 - 1.0.12 — 2019-05-30 - 1.0.11 — 2019-05-29 - 1.0.10 — 2019-03-05 - 1.0.9 — 2018-05-10 - 1.0.8 — 2017-04-27 - … 7 more at https://npm.io/package/@ffprobe-installer/ffprobe/versions ## README # node-ffprobe-installer [![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-) [![npm](https://img.shields.io/npm/dt/@ffprobe-installer/ffprobe.svg?style=flat-square)](https://www.npmjs.com/package/@ffprobe-installer/ffprobe) [![npm](https://img.shields.io/npm/v/@ffprobe-installer/ffprobe.svg?style=flat-square)](https://www.npmjs.com/package/@ffprobe-installer/ffprobe?activeTab=versions) [![xo](https://img.shields.io/badge/code%20style-XO-60CFBE.svg?longCache=true&style=flat-square&logo=)](https://github.com/xojs/xo) [![Build Status](https://img.shields.io/github/actions/workflow/status/SavageCore/node-ffprobe-installer/npm-test.yml?branch=master)](https://github.com/SavageCore/node-ffprobe-installer/actions/workflows/npm-test.yml) [![Codecov](https://img.shields.io/codecov/c/github/SavageCore/node-ffprobe-installer.svg?style=flat-square)](https://codecov.io/gh/SavageCore/node-ffprobe-installer/) Platform independent binary installer of [FFprobe](https://ffmpeg.org/) for node projects. Useful for tools that should "just work" in multiple environments. Installs a standalone static binary of `ffprobe` for the current platform and provides a path and version. Supports Linux, Windows 7+, and MacOS 10.9+. A combination of package.json fields `optionalDependencies`, `cpu`, and `os` lets the installer only download the binary for the current platform. See also [Warnings during install](https://github.com/SavageCore/node-ffprobe-installer/blob/master/README.md#warnings-during-install). Supports Node >= 14.21.2 ## Install npm install --save @ffprobe-installer/ffprobe ## Usage examples ```javascript const ffprobe = require('@ffprobe-installer/ffprobe'); console.log(ffprobe.path, ffprobe.version); ``` ### [process.spawn()](https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options) ```javascript const ffprobePath = require('@ffprobe-installer/ffprobe').path; const spawn = require('child_process').spawn; const ffprobe = spawn(ffprobePath, args); ffprobe.on('exit', onExit); ``` ### [fluent-ffmpeg](https://github.com/fluent-ffmpeg/node-fluent-ffmpeg) ```javascript const ffprobePath = require('@ffprobe-installer/ffprobe').path; const ffmpeg = require('fluent-ffmpeg'); ffmpeg.setFfprobePath(ffprobePath); ``` ## Warnings during install To automatically choose the binary to install, [optionalDependencies](https://docs.npmjs.com/files/package.json#optionaldependencies) are used. This currently outputs warnings in the console, an issue for that is [tracked by the npm team here](https://github.com/npm/npm/issues/9567). ## Known Issues ### AWS and/or Elastic Beanstalk If you get permissions issues, try adding a .npmrc file with the following: unsafe-perm=true See [node-ffmpeg-installer/issues/21](https://github.com/kribblo/node-ffmpeg-installer/issues/21) ### Wrong path under Electron with Asar enabled It's a [known issue](https://github.com/electron-userland/electron-packager/issues/740) that Asar breaks native paths. As a workaround, if you use Asar, you can do something like this: ```javascript const ffprobePath = require('@ffprobe-installer/ffprobe').path.replace( 'app.asar', 'app.asar.unpacked' ); ``` ## The binaries Downloaded from the sources listed at [ffmpeg.org](https://ffmpeg.org/download.html): - Linux (armhf, arm64, ia32, x64) (20230721-c2b3861): https://www.johnvansickle.com/ffmpeg/ - macOS (x64) (20230213-f8d6d0f): https://evermeet.cx/ffmpeg/ - macOS (arm64) (5.1.2-7268323): contributed by [wongyiuhang](https://github.com/wongyiuhang) - Windows 32-bit (20230213-f8d6d0f): https://github.com/sudo-nautilus/FFmpeg-Builds-Win32/ - Windows 64-bit (20230213-2296078): https://www.gyan.dev/ffmpeg/builds/ For version updates, submit issue or pull request. ## Upload new versions In every updated `platforms/*` directory: npm run upload ## See also - [node-ffmpeg-installer](https://www.npmjs.com/package/@ffmpeg-installer/ffmpeg) - This project is a fork of ffmpeg-installer ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Jonas Dautel
Jonas Dautel
💻		 Kiko Beats
Kiko Beats
💻		 Kaan Ozdokmeci
Kaan Ozdokmeci
📖		 Sergio Maria Matone
Sergio Maria Matone
💻		 Sebastian
Sebastian
💻		 Wong Yiu Hang
Wong Yiu Hang
💻
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind are welcome! --- _Source: https://npm.io/package/@ffprobe-installer/ffprobe · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._