brew / approval gates

Install ffmpeg with Homebrew, apk, chocolatey, apt, dnf, MacPorts, pacman, scoop, winget, zypper

Play, record, convert, and stream select audio and video codecs. Version 8.1.2 via Homebrew; verified 2026-07-05.

Install command Security notes

agent safety

Agent safety answer

ffmpeg processes media files and can read or overwrite local artifacts.

Credential access

Can read input files, network URLs, and metadata that may be sensitive.

Remote mutation

Usually local, but supports network inputs and outputs.

Publish/artifact risk

Can create, overwrite, or stream media artifacts.

Recommended control

Gate network outputs, overwrites, and reads from sensitive paths.

Agent-use guidance

Allow local transforms in safe directories; require approval for overwrites, uploads, and sensitive inputs.

install

Additional install commands

macOS

Homebrewverified · 100%

brew install ffmpeg

local Homebrew formula metadata

MacPortsverified · 94%

sudo port install ffmpeg

MacPorts ports tree · multimedia/ffmpeg/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%

sudo apk add ffmpeg

Alpine Linux edge package indexes · ffmpeg · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%

sudo apt install ffmpeg

Debian stable package indexes · ffmpeg · source: deb.debian.org

Fedora dnfverified · 92%

sudo dnf install ffmpeg-free

Fedora Rawhide package metadata · ffmpeg-free · source: dl.fedoraproject.org

Arch Linux pacmanverified · 92%

sudo pacman -S ffmpeg

Arch Linux sync databases · ffmpeg · source: geo.mirror.pkgbuild.com

openSUSE zypperverified · 92%

sudo zypper install ffmpeg-4

openSUSE Tumbleweed package metadata · ffmpeg-4 · source: download.opensuse.org

Windows

Chocolateyverified · 92%

choco install ffmpeg

Chocolatey community package catalog · ffmpeg · source: community.chocolatey.org

Scoopverified · 92%

scoop install main/ffmpeg

Scoop official bucket manifest trees · bucket/ffmpeg.json · source: api.github.com

Windows Package Managerverified · 92%

winget install --id Gyan.FFmpeg -e

Windows Package Manager source index · Gyan.FFmpeg · source: cdn.winget.microsoft.com

overview

Package summary

Play, record, convert, and stream select audio and video codecs

Project links

Commands and aliases

aviocat
bisect-create
check_arm_indent.sh
clean-diff
compare-cvelists.sh
crypto_bench
cws2fws
dvd2concat
enc_recon_frame_test
enum_options
ffescape
ffeval
ffhash
ffmpeg
ffplay
ffprobe
fourcc2pixfmt
gen-rc
general_assembly.pl
graph2dot
indent_arm_assembly.pl
ismindex
loudnorm.rb
make_chlayout_test
merge-all-source-plugins
missing_codec_desc
murge
normalize.py
patcheck
pktdumper
plotframes
probetest

history

Project history and usage

FFmpeg is one of the canonical command-line multimedia packages: a source-first upstream project, a set of reusable codec/container/filter libraries, and the `ffmpeg`, `ffplay`, and `ffprobe` tools used everywhere from one-line conversions to production media pipelines.

Project history

The official project describes FFmpeg as a multimedia framework that can decode, encode, transcode, mux, demux, stream, filter, and play media across formats from old obscure inputs to cutting-edge codecs. Its architecture combines user-facing tools with libraries such as libavcodec, libavformat, libavfilter, libavdevice, libswscale, and libswresample.

FFmpeg's upstream culture is explicitly developer-driven and source-first. The download page says FFmpeg provides source code and points users to distributions and build providers for compiled packages. It also notes that development branch snapshots are often used because the project changes constantly and release branches cherry-pick selected fixes.

Adoption history

FFmpeg's adoption is visible in its official packaging guidance: the project links to Debian, Ubuntu, Fedora/RHEL, Windows, and macOS build sources rather than shipping one blessed binary for every platform. That mirrors how FFmpeg became a package-manager staple rather than only an application downloaded from upstream.

The release process is oriented toward distributors and system integrators. Upstream documents roughly six-month major releases with point releases for important fixes, release signatures, git tags, and branch-specific release notes.

How it is used

The core command-line pattern is `ffmpeg -i input output`: read one or more inputs, select streams, optionally filter or transcode them, and write one or more outputs. `ffprobe` is used to inspect streams and metadata, while `ffplay` provides a simple player based on FFmpeg libraries.

Package users care about the exact build because enabled libraries determine available encoders, decoders, filters, devices, and protocols. A stock distro build, Homebrew build, static Windows build, and custom source build can all behave differently while sharing the same upstream name.

Why package nerds care

FFmpeg is a package-manager stress test: it touches codec licensing, optional dependencies, hardware acceleration, network protocols, security updates for untrusted media parsing, and ABI-sensitive libraries consumed by other applications.

Its combination of command-line tools and shared libraries means it is both an end-user utility and infrastructure for other media software. That dual identity is why package maintainers track branch support, dependency choices, and security backports closely.

Timeline

2011: FFmpeg release signing key date documented by upstream release verification instructions.
2015: FFmpeg 2.8 branch cut from master on 2015-09-05, later maintained through 2.8.22.
2024-2026: Upstream release pages show active major/minor release branches and point releases for distributors and integrators.
2026: FFmpeg 8.1.2 listed as a stable source release on the official download page.

Related projects

ffmpeg-full is a Homebrew formula variant with a broader optional dependency set.
ffmpeg2theora is an older converter that used FFmpeg decoding to produce Ogg Theora/Vorbis outputs.
FFmate is a newer automation layer that runs FFmpeg behind a server/API workflow.

Sources

approval gates

Human review metadata for risky commands

The local approval-gate seed includes 4 rules for ffmpeg. Covered entrypoints: ffmpeg, ffplay, ffprobe. Severity labels: high, medium. Coverage: partial, reviewed 2026-05-21.

Example gated actions

Overwrite output files without an interactive prompt.
Send generated media to a network endpoint.
Capture from local audio, video, screen, or device inputs.
Expand allowed protocols for nested media inputs.

executables

Installed executables

Command	Kind	Exposure
`aviocat`	cli	global executable
`bisect-create`	cli	global executable
`check_arm_indent.sh`	cli	global executable
`clean-diff`	cli	global executable
`compare-cvelists.sh`	cli	global executable
`crypto_bench`	cli	global executable
`cws2fws`	cli	global executable
`dvd2concat`	cli	global executable
`enc_recon_frame_test`	cli	global executable
`enum_options`	cli	global executable
`ffescape`	cli	global executable
`ffeval`	cli	global executable
`ffhash`	cli	global executable
`ffmpeg`	cli	global executable
`ffplay`	cli	global executable
`ffprobe`	cli	global executable
`fourcc2pixfmt`	cli	global executable
`gen-rc`	cli	global executable
`general_assembly.pl`	cli	global executable
`graph2dot`	cli	global executable
`indent_arm_assembly.pl`	cli	global executable
`ismindex`	cli	global executable
`loudnorm.rb`	cli	global executable
`make_chlayout_test`	cli	global executable
`merge-all-source-plugins`	cli	global executable
`missing_codec_desc`	cli	global executable
`murge`	cli	global executable
`normalize.py`	cli	global executable
`patcheck`	cli	global executable
`pktdumper`	cli	global executable
`plotframes`	cli	global executable
`probetest`	cli	global executable
`qt-faststart`	cli	global executable
`scale_slice_test`	cli	global executable
`seek_print`	cli	global executable
`sidxindex`	cli	global executable
`source2c`	cli	global executable
`target_dec_fate.sh`	cli	global executable
`trasher`	cli	global executable
`uncoded_frame`	cli	global executable
`unwrap-diff`	cli	global executable
`venc_data_dump`	cli	global executable
`zmqshell.py`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version8.1.2

manager updated2026-07-05

local dataok

upstreamnot checked

latest detectednot detected

Package key	brew:ffmpeg
Version	8.1.2
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/ffmpeg
Homepage	https://ffmpeg.org/
Repository	https://git.ffmpeg.org/ffmpeg.git
Upstream docs	https://ffmpeg.org/documentation.html
License	GPL-3.0-or-later
Source archive	https://ffmpeg.org/releases/ffmpeg-8.1.2.tar.xz
Last updated	2026-07-05T23:07:18Z
Pulse	updated
Dependencies	dav1d, lame, libvmaf, libvpx, openssl@3, opus, sdl2-compat, svt-av1, x264, x265
Build dependencies	pkgconf
Uses from macOS	bzip2, libxml2
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared
Caveats	ffmpeg-full includes additional tools and libraries that are not included in the regular ffmpeg formula.

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	ffmpeg
Aliases	ffmpeg@8
Version Scheme	0
Revision	1
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable