# ffmpeg-ffprobe-static

> ffmpeg and ffprobe static binaries for Mac OSX, Linux, and Windows

Latest version **6.1.2-rc.1** (published 2024-10-29) · GPL-3.0-or-later license · 0 weekly downloads

## Install

```sh
npm install ffmpeg-ffprobe-static
pnpm add ffmpeg-ffprobe-static
yarn add ffmpeg-ffprobe-static
bun add ffmpeg-ffprobe-static
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 6.1.2-rc.1 |
| Published | 2024-10-29 |
| First published | 2020-09-10 |
| Weekly downloads | 0 |
| License | GPL-3.0-or-later |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=10 |
| Dependencies | 4 |
| Unpacked size | 14.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | yes |
| GitHub stars | 31 |
| Maintainers | descript-ci |
| Keywords | ffmpeg, ffprobe, static, library, binary, binaries, mac, linux, windows |

## Links

- npm: https://www.npmjs.com/package/ffmpeg-ffprobe-static
- Repository: https://github.com/descriptinc/ffmpeg-ffprobe-static
- Homepage: https://github.com/descriptinc/ffmpeg-ffprobe-static#readme
- Issues: https://github.com/descriptinc/ffmpeg-ffprobe-static/issues
- npm.io page: https://npm.io/package/ffmpeg-ffprobe-static

## Dependencies (4)

- [progress](https://npm.io/package/progress.md) ^2.0.3
- [env-paths](https://npm.io/package/env-paths.md) ^2.2.0
- [https-proxy-agent](https://npm.io/package/https-proxy-agent.md) ^5.0.0
- [@derhuerst/http-basic](https://npm.io/package/@derhuerst/http-basic.md) 8.2.4

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 6.1.2-rc.1 (latest) — 2024-10-29
- 7.1.0-rc.1 — 2024-10-24
- 5.1.0-rc.1 — 2024-08-22
- 6.1.1-rc.5 — 2024-07-24
- 6.1.1-rc.4 — 2024-07-24
- 6.1.1-rc.3 — 2024-06-12
- 6.1.1-rc.2 — 2024-06-07
- 6.1.1 — 2024-03-19
- 6.0.0 — 2023-09-16
- 4.4.0-rc.11 — 2021-12-15
- 4.3.1-rc.6 — 2021-02-03
- 4.3.1-rc.5 — 2021-02-03
- 4.3.1-rc.4 — 2021-02-03
- 4.3.1-rc.3 — 2021-02-02
- 4.3.1-rc.2 — 2020-09-10
- … 1 more at https://npm.io/package/ffmpeg-ffprobe-static/versions

## README

# ffmpeg-ffprobe-static

Fork of [ffmpeg-static](https://github.com/eugeneware/ffmpeg-static) that includes ffprobe.

## Info

**[ffmpeg](https://ffmpeg.org) 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 `6.0`.](https://github.com/descriptinc/ffmpeg-ffprobe-static/releases/tag/b6.0)

*Note:* The version of `ffmpeg-ffprobe-static` follows [SemVer](http://semver.org). 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](https://docs.npmjs.com/files/package.json#dependencies) or use a [lockfile](https://docs.npmjs.com/files/package-lock.json).

[![npm version](https://img.shields.io/npm/v/ffmpeg-ffprobe-static.svg)](https://www.npmjs.com/package/ffmpeg-ffprobe-static)
[![Actions Status](https://github.com/descriptinc/ffmpeg-ffprobe-static/workflows/test/badge.svg)](https://github.com/descriptinc/ffmpeg-ffprobe-static/actions)
![minimum Node.js version](https://img.shields.io/node/v/ffmpeg-ffprobe-static.svg)

## Installation

This module is installed via npm:

``` bash
$ npm install ffmpeg-ffprobe-static
```

*Note:* During installation, it will download the appropriate `ffmpeg` binary from the [`b6.0` GitHub release](https://github.com/descriptinc/ffmpeg-ffprobe-static/releases/tag/b6.0). 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](https://github.com/eugeneware/ffmpeg-static/issues/35#issuecomment-630225392)).

## Example Usage

Returns the path of a statically linked ffmpeg binary on the local filesystem.

``` js
var pathToFfmpeg = require('ffmpeg-ffprobe-static');
console.log(pathToFfmpeg);
```

```
/Users/j/playground/node_modules/ffmpeg-ffprobe-static/ffmpeg
```

Check the [example script](example.js) for a more thorough example.

## Sources of the binaries

[The build script](build/index.sh) downloads binaries from these locations:

- [Windows x64 builds](https://github.com/ShareX/FFmpeg/)
- [Windows x86 builds](https://github.com/sudo-nautilus/FFmpeg-Builds-Win32/)
- [Linux builds](https://johnvansickle.com/ffmpeg/)
- macOS builds [for Intel](https://evermeet.cx/pub/ffmpeg/) / [for ARM (Apple Silicon)](https://osxexperts.net/)
- [FreeBSD builds](https://github.com/Thefrank/ffmpeg-static-freebsd/releases)

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](https://getsharex.com/donate/)
- **Linux builds**: [John Van Sickle](https://www.johnvansickle.com/ffmpeg/)
- **macOS builds**: [Helmut K. C. Tessarek](https://evermeet.cx/ffmpeg/#donations)

## Building the project

The `unzip`, `tar` CLI executables need to be installed. On macOS, use `brew install gnu-tar xz`.

---
_Source: https://npm.io/package/ffmpeg-ffprobe-static · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._