# Install ffmpegthumbnailer with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, scoop, zypper

Create thumbnails for your video files. Version 2.3.0 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:ffmpegthumbnailer
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ffmpegthumbnailer
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install ffmpegthumbnailer
```

  Evidence: MacPorts ports tree: multimedia/ffmpegthumbnailer/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add ffmpegthumbnailer
```

  Evidence: Alpine Linux edge package indexes: ffmpegthumbnailer from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install ffmpegthumbnailer
```

  Evidence: Debian stable package indexes: ffmpegthumbnailer from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install ffmpegthumbnailer
```

  Evidence: Fedora Rawhide package metadata: ffmpegthumbnailer from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#ffmpegthumbnailer
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ff/ffmpegthumbnailer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S ffmpegthumbnailer
```

  Evidence: Arch Linux sync databases: ffmpegthumbnailer from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install ffmpegthumbnailer
```

  Evidence: openSUSE Tumbleweed package metadata: ffmpegthumbnailer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/ffmpegthumbnailer
```

  Evidence: Scoop official bucket manifest trees: bucket/ffmpegthumbnailer.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:ffmpegthumbnailer
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ffmpegthumbnailer>
- **Version:** 2.3.0
- **Source summary:** Create thumbnails for your video files
- **Homepage:** <https://github.com/dirkvdb/ffmpegthumbnailer>
- **Repository:** <https://github.com/dirkvdb/ffmpegthumbnailer>
- **Upstream docs:** <https://github.com/dirkvdb/ffmpegthumbnailer#readme>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://github.com/dirkvdb/ffmpegthumbnailer/archive/refs/tags/v2.3.0.tar.gz>
- **Last updated:** 2026-06-22T14:03:20-07:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- ffmpegthumbnailer (cli)
- ffmpegthumbnailer (alias)

## Dependencies

- ffmpeg
- jpeg-turbo
- libpng

## Build dependencies

- cmake
- pkgconf

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.3.0
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/dirkvdb/ffmpegthumbnailer
- Upstream latest detected: v2.3.0 (current)
## Project history and usage

ffmpegthumbnailer is a small FFmpeg-based thumbnail generator for video files, designed for file managers and other desktop software that need quick previews.

### Project history

The project describes itself as a lightweight video thumbnailer that uses FFmpeg to decode frames, with supported formats depending on how FFmpeg was built. Its early changelog starts at version 1.0 as the initial FFmpegThumbnailer release, and version 1.2.0 added libffmpegthumbnailer so applications could use it as a library instead of only a command-line tool.

The 2.x line modernized the project around a C++ library namespace, C API changes, CMake, and GitHub hosting. Later releases focused on practical desktop-thumbnailer concerns: rotation metadata, embedded image metadata, raw RGB output, command-line argument checks, compatibility with newer FFmpeg, and an optional audio thumbnailer.

### Adoption history

ffmpegthumbnailer was adopted in package managers because it fills a narrow but recurring desktop need: produce thumbnails for arbitrary video formats using the same codec coverage FFmpeg already provides. Homebrew packages the single ffmpegthumbnailer executable, and the project also exposes a library for applications that want thumbnail generation directly.

### How it is used

Typical use is either direct CLI thumbnail generation or integration by a file manager/desktop thumbnail service. Because it delegates decoding to FFmpeg, its practical media coverage follows the FFmpeg build options available on the system.

### Why package nerds care

This is the kind of package maintainers like to keep boring: a tiny binary, a library, FFmpeg plus libpng dependencies, and a clear job. Its recurring build fixes against newer FFmpeg releases are the main maintenance story.

### Timeline

- 1.0: Initial FFmpegThumbnailer release.
- 1.2.0: Added libffmpegthumbnailer library access.
- 2.0.10: Migrated to GitHub and CMake.
- 2016: Version 2.2.0 added embedded image metadata preference.
- 2024: Version 2.2.3 fixed builds against newer FFmpeg and compilers.
- 2025: Version 2.3.0 added an optional audio thumbnailer.

### Related projects

- FFmpeg supplies the decoding layer. File managers and desktop thumbnail services are the main integration targets.

### Sources

- <https://github.com/dirkvdb/ffmpegthumbnailer/blob/master/README>
- <https://github.com/dirkvdb/ffmpegthumbnailer/blob/master/ChangeLog>
- <https://github.com/dirkvdb/ffmpegthumbnailer/releases>
- <https://formulae.brew.sh/formula/ffmpegthumbnailer>


## 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:** ffmpegthumbnailer
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - ffmpegthumbnailer - 2.2.3-2: normalized package name match | Debian stable package indexes: ffmpegthumbnailer from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | fast and lightweight video thumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- Debian apt - libffmpegthumbnailer-dev - 2.2.3-2: normalized package name match | Debian stable package indexes: libffmpegthumbnailer-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | development files for ffmpegthumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- Debian apt - libffmpegthumbnailer4v5 - 2.2.3-2: normalized package name match | Debian stable package indexes: libffmpegthumbnailer4v5 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | shared library for ffmpegthumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- Nix - ffmpegthumbnailer: normalized package name match | nixpkgs package indexes: pkgs/by-name/ff/ffmpegthumbnailer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - ffmpegthumbnailer - 2.2.2+git20240104+dfsg-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: ffmpegthumbnailer from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | fast and lightweight video thumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- Ubuntu apt - libffmpegthumbnailer-dev - 2.2.2+git20240104+dfsg-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libffmpegthumbnailer-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | development files for ffmpegthumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- Ubuntu apt - libffmpegthumbnailer4v5 - 2.2.2+git20240104+dfsg-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libffmpegthumbnailer4v5 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | shared library for ffmpegthumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- apk - ffmpegthumbnailer - 2.2.4-r0: normalized package name match | Alpine Linux edge package indexes: ffmpegthumbnailer from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Lightweight video thumbnailer that can be used by file managers | https://github.com/dirkvdb/ffmpegthumbnailer
- apk - ffmpegthumbnailer-dev - 2.2.4-r0: normalized package name match | Alpine Linux edge package indexes: ffmpegthumbnailer-dev from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Lightweight video thumbnailer that can be used by file managers (development files) | https://github.com/dirkvdb/ffmpegthumbnailer
- apk - ffmpegthumbnailer-doc - 2.2.4-r0: normalized package name match | Alpine Linux edge package indexes: ffmpegthumbnailer-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Lightweight video thumbnailer that can be used by file managers (documentation) | https://github.com/dirkvdb/ffmpegthumbnailer
- dnf - ffmpegthumbnailer - 2.3.0-2.fc44: normalized package name match | Fedora Rawhide package metadata: ffmpegthumbnailer from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Lightweight video thumbnailer that can be used by file managers | https://github.com/dirkvdb/ffmpegthumbnailer
- dnf - ffmpegthumbnailer-devel - 2.3.0-2.fc44: normalized package name match | Fedora Rawhide package metadata: ffmpegthumbnailer-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Development files for ffmpegthumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- dnf - ffmpegthumbnailer-libs - 2.3.0-2.fc44: normalized package name match | Fedora Rawhide package metadata: ffmpegthumbnailer-libs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Library for ffmpegthumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer
- pacman - ffmpegthumbnailer - 2.3.0-1: normalized package name match | Arch Linux sync databases: ffmpegthumbnailer from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Lightweight video thumbnailer that can be used by file managers | https://github.com/dirkvdb/ffmpegthumbnailer
- zypper - ffmpegthumbnailer - 2.2.3-1.6: normalized package name match | openSUSE Tumbleweed package metadata: ffmpegthumbnailer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Video thumbnailer that can be used by file managers | https://github.com/dirkvdb/ffmpegthumbnailer
- zypper - libffmpegthumbnailer-devel - 2.2.3-1.6: normalized package name match | openSUSE Tumbleweed package metadata: libffmpegthumbnailer-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Development files for ffmpegthumbnailer | https://github.com/dirkvdb/ffmpegthumbnailer


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Runtime dependency declared by Homebrew.
- [jpeg-turbo](https://www.automicvault.com/pkg/brew/jpeg-turbo/) - Runtime dependency declared by Homebrew.
- [libpng](https://www.automicvault.com/pkg/brew/libpng/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [geeqie](https://www.automicvault.com/pkg/brew/geeqie/) - Popular package that depends on this formula.
- [ffms2](https://www.automicvault.com/pkg/brew/ffms2/) - Shares av.db curated category or tags: cli, ffmpeg, media, video.
- [video-compare](https://www.automicvault.com/pkg/brew/video-compare/) - Shares av.db curated category or tags: cli, ffmpeg, 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.
- [ffmate](https://www.automicvault.com/pkg/brew/ffmate/) - Shares av.db curated category or tags: cli, ffmpeg, media, video.
- [epeg](https://www.automicvault.com/pkg/brew/epeg/) - Both packages work with overlapping file formats or content types. Shared terms: cli, image, jpeg, jpeg-turbo, media.
- [libavif](https://www.automicvault.com/pkg/brew/libavif/) - Both packages work with overlapping file formats or content types. Shared terms: cli, files, image, jpeg, jpeg-turbo.

## Combined YAML source

View the package source record on GitHub. [combined/ffmpegthumbnailer.yml](https://github.com/automic-vault/db/blob/main/combined/ffmpegthumbnailer.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
- external package-manager database matches
- cross-ecosystem install command graph
