# Install ffmpeg2theora with Homebrew Convert video files to Ogg Theora format. Version 0.30 via Homebrew; verified 2026-06-22. ## Install ```sh sudo av install brew:ffmpeg2theora ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install ffmpeg2theora ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:ffmpeg2theora - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.30 - **Source summary:** Convert video files to Ogg Theora format - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-2.0-or-later - **Source archive:** - **Last updated:** 2026-06-22T14:03:20-07:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - ffmpeg2theora (cli) - ffmpeg2theora (alias) ## Dependencies - ffmpeg@4 - libkate - libogg - libvorbis - theora ## Build dependencies - pkgconf - scons ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.30 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://gitlab.xiph.org/xiph/ffmpeg2theora - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage ffmpeg2theora is a focused converter from the Ogg/Theora era: it uses FFmpeg's decoding reach to turn media files into Ogg Theora video and Ogg Vorbis audio. ### Project history The official README states the original idea plainly: convert anything FFmpeg could decode into Theora, with a binary that could be deployed alongside sites such as v2v.cc so many people could encode clips with the same settings. The changelog begins at 0.1 and shows a rapid 2004-era evolution: resize options, quality controls, stdin and Kino export work, presets, cropping, metadata, stream selection, and better support for FFmpeg API changes. ### Adoption history ffmpeg2theora belongs to the period when Ogg Theora/Vorbis was a prominent free-software web/video target. Its official materials mention a Kino export plugin, subtitles embedded in Ogg streams, frontend modes, and default `.ogv` output, all signs of practical adoption around desktop video and web publishing workflows. Later changelog entries show maintenance following FFmpeg and libtheora changes through releases such as 0.27 with FFmpeg 0.6, 0.28 with FFmpeg 0.7, 0.29 with current FFmpeg API updates, and 0.30 with FFmpeg 2.9 compile fixes. ### How it is used The basic official usage is intentionally simple: run `ffmpeg2theora clip.avi` and get `clip.ogv`. The manpage documents options for output files, Ogg Skeleton metadata, seek indexes, start/end times, presets, quality/bitrate settings, scaling, cropping, deinterlacing, subtitles, and two-pass encoding. Its package role is narrower than FFmpeg itself: install it when the desired output is specifically Ogg Theora/Vorbis and a dedicated converter is more convenient than composing a raw FFmpeg command. ### Why package nerds care ffmpeg2theora is historically interesting because it packages a policy decision on top of FFmpeg: decode broadly, encode to a free Ogg/Theora target with shared defaults. For maintainers, it also illustrates the cost of small codec-wrapper tools that ride FFmpeg internals. The changelog repeatedly records updates needed as FFmpeg APIs, libtheora, and Ogg tooling changed. ### Timeline - 2004: 0.1 initial version appears in the official changelog. - 2004: 0.5 adds Kino export work and stdin support. - 2008: 0.21 switches the default extension to `.ogv` and enables Ogg Skeleton by default. - 2009: 0.25 adds JSON source info, stream selection, libtheora 1.1 API work, and two-pass encoding. - 2014: 0.30 ships bug fixes and FFmpeg 2.9 compile updates. ### Related projects - FFmpeg provides the decoding foundation. - Theora, Vorbis, Ogg Skeleton, libkate, and Kino are related technologies or integrations documented by the project. ### Sources - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** ffmpeg2theora - **Version Scheme:** 0 - **Revision:** 12 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** yes - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [ffmpeg@4](https://www.automicvault.com/pkg/brew/ffmpeg-4/) - Runtime dependency declared by Homebrew. - [libkate](https://www.automicvault.com/pkg/brew/libkate/) - Runtime dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [scons](https://www.automicvault.com/pkg/brew/scons/) - Build dependency declared by Homebrew. - [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Shares av.db curated category or tags: cli, encoding, media, video. - [ffmpeg-full](https://www.automicvault.com/pkg/brew/ffmpeg-full/) - Shares av.db curated category or tags: cli, encoding, media, video. - [bento4](https://www.automicvault.com/pkg/brew/bento4/) - Shares av.db curated category or tags: cli, media, video. - [ccextractor](https://www.automicvault.com/pkg/brew/ccextractor/) - Shares av.db curated category or tags: cli, media, video. - [dvanalyzer](https://www.automicvault.com/pkg/brew/dvanalyzer/) - Shares av.db curated category or tags: cli, media, video. - [dvr-scan](https://www.automicvault.com/pkg/brew/dvr-scan/) - Shares av.db curated category or tags: cli, media, video. - [ffmpegthumbnailer](https://www.automicvault.com/pkg/brew/ffmpegthumbnailer/) - Shares av.db curated category or tags: cli, media, video. - [ffms2](https://www.automicvault.com/pkg/brew/ffms2/) - Shares av.db curated category or tags: cli, media, video. - [oggz](https://www.automicvault.com/pkg/brew/oggz/) - Both packages work with overlapping file formats or content types. Shared terms: cli, files, libogg, media, ogg. ## Combined YAML source View the package source record on GitHub. [combined/ffmpeg2theora.yml](https://github.com/automic-vault/db/blob/main/combined/ffmpeg2theora.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph