brew / approval gates / rank 18

Install ffmpeg with Homebrew

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

provider-native install command

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	Note
`aviocat`	executable	indexed executable	Discovered from the local executable index.
`bisect-create`	executable	indexed executable	Discovered from the local executable index.
`check_arm_indent.sh`	executable	indexed executable	Discovered from the local executable index.
`clean-diff`	executable	indexed executable	Discovered from the local executable index.
`compare-cvelists.sh`	executable	indexed executable	Discovered from the local executable index.
`crypto_bench`	executable	indexed executable	Discovered from the local executable index.
`cws2fws`	executable	indexed executable	Discovered from the local executable index.
`dvd2concat`	executable	indexed executable	Discovered from the local executable index.
`enc_recon_frame_test`	executable	indexed executable	Discovered from the local executable index.
`enum_options`	executable	indexed executable	Discovered from the local executable index.
`ffescape`	executable	indexed executable	Discovered from the local executable index.
`ffeval`	executable	indexed executable	Discovered from the local executable index.
`ffhash`	executable	indexed executable	Discovered from the local executable index.
`ffmpeg`	executable	indexed executable	Discovered from the local executable index.
`ffplay`	executable	indexed executable	Discovered from the local executable index.
`ffprobe`	executable	indexed executable	Discovered from the local executable index.
`fourcc2pixfmt`	executable	indexed executable	Discovered from the local executable index.
`gen-rc`	executable	indexed executable	Discovered from the local executable index.
`general_assembly.pl`	executable	indexed executable	Discovered from the local executable index.
`graph2dot`	executable	indexed executable	Discovered from the local executable index.
`indent_arm_assembly.pl`	executable	indexed executable	Discovered from the local executable index.
`ismindex`	executable	indexed executable	Discovered from the local executable index.
`loudnorm.rb`	executable	indexed executable	Discovered from the local executable index.
`make_chlayout_test`	executable	indexed executable	Discovered from the local executable index.
`merge-all-source-plugins`	executable	indexed executable	Discovered from the local executable index.
`missing_codec_desc`	executable	indexed executable	Discovered from the local executable index.
`murge`	executable	indexed executable	Discovered from the local executable index.
`normalize.py`	executable	indexed executable	Discovered from the local executable index.
`patcheck`	executable	indexed executable	Discovered from the local executable index.
`pktdumper`	executable	indexed executable	Discovered from the local executable index.
`plotframes`	executable	indexed executable	Discovered from the local executable index.
`probetest`	executable	indexed executable	Discovered from the local executable index.
`qt-faststart`	executable	indexed executable	Discovered from the local executable index.
`scale_slice_test`	executable	indexed executable	Discovered from the local executable index.
`seek_print`	executable	indexed executable	Discovered from the local executable index.
`sidxindex`	executable	indexed executable	Discovered from the local executable index.
`source2c`	executable	indexed executable	Discovered from the local executable index.
`target_dec_fate.sh`	executable	indexed executable	Discovered from the local executable index.
`trasher`	executable	indexed executable	Discovered from the local executable index.
`uncoded_frame`	executable	indexed executable	Discovered from the local executable index.
`unwrap-diff`	executable	indexed executable	Discovered from the local executable index.
`venc_data_dump`	executable	indexed executable	Discovered from the local executable index.
`zmqshell.py`	executable	indexed executable	Discovered from the local executable index.

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-08-03

manager version8.1.2

manager updated2026-07-05

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:ffmpeg
Version	8.1.2
Package manager	Homebrew
Homepage	https://ffmpeg.org/
Repository	https://github.com/FFmpeg/FFmpeg
Last updated	2026-07-05T23:07:18Z
Pulse	updated
Bottle	not recorded
Service	none declared

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/ffmpeg.yml

Used sources

Geiger risk classifier
Nucleus package database
approval-gate seed metadata
curated agent safety answer
curated package history
pkgdb category and tag curation