FFmpeg-update is a package manager for the FFmpeg suite, available as both a CLI tool and a Python library. It fetches pre-built, static binaries published by Martin Riedl.

[!NOTE] Supported Platforms (Upstream): Linux amd64, Linux arm64v8, macOS Intel (Deprecated), Apple Silicon

Features

• Atomic installation
• Concurrent downloads
• Download progress bars
• Configurable installation directory
• Latest release and snapshot builds available
• Automatic sudo escalation for privileged installation directory
• Automatic operating system and machine architecture detection

Installation

pip install ffmpeg-update

The installation provides the ffup executable.

CLI Reference

Usage

ffup <install|update [--dry-run]|check|uninstall> [OPTIONS] [ffmpeg] [ffprobe] [ffplay]

Alternatively, can be invoked as a module with python -m ffmpeg_update <COMMAND>.

[!TIP] Multiple names can be passed, e.g., ffup install ffmpeg ffprobe

[!NOTE] Default is ffmpeg, if no name is passed

Parameters

• --dir: The path to the installation directory

  • Default: ~/.local/bin
  • Environment variable: $FFUP_DIR, $XDG_BIN_HOME
  • Commands: check, install, uninstall, update

• --build: The build type

  • Default: snapshot
  • Choices: release, snapshot
  • Environment Variable: $FFUP_BUILD
  • Commands: check, install, update

• --arch: The machine architecture

  • Default: Auto-detect using platform.machine()
  • Choices: amd64, arm64
  • Environment Variable: $FFUP_ARCH
  • Commands: check, install, update

• --os: The operating system

  • Default: Auto-detect using platform.system()
  • Choices: linux, macos
  • Environment Variable: $FFUP_OS
  • Commands: check, install, update

• --dry-run: A flag to skip download/install, and only check for updates

  • Default: False
  • Commands: update
  • Note: ffup check is an alias for ffup update --dry-run

API Reference

Functions

• async update(bins = {"ffmpeg"}, /, *, dry_run = False, dir, tempdir, progress, client) -> None
• async install(bins = {"ffmpeg"}, /, *, dir, tempdir, progress, client) -> None
• uninstall(bins = {"ffmpeg"}, /, *, dir) -> None
• get_arch() -> Literal["amd64", "arm64"]
• get_os() -> Literal["linux", "macos"]

• bins: A set of binary names

  • Must contain one or more of "ffmpeg", "ffprobe", and "ffplay"

• dry_run: A bool indicating whether to skip download/install

• dir: A pathlib.Path to the installation directory

  • Must exist and be absolute

• tempdir: A tempfile.TemporaryDirectory[str] used to store and extract the downloaded archives

• progress: A rich.progress.Progress used to show progress bars in the terminal

• client: A niquests.AsyncSession used to make HTTP requests

  • Must set parameter base_url to f"https://ffmpeg.martin-riedl.de/redirect/latest/{os}/{arch}/{build}/"
  • build: "release", "snapshot"
  • arch: "amd64", "arm64"
  • os: "linux", "macos"