Registry / devops / static-ffmpeg

static-ffmpeg

JSON →
library3.0pypypi✓ verified 80d ago

Provides a static download of ffmpeg for cross-platform use, ensuring a consistent ffmpeg binary across different systems. Current version 3.0, updated irregularly.

pip install static-ffmpeg
INSTALL
IMPORT
SIG · STATIC-FFMPEG
S
static-ffmpeg
devopspythonv3.0
Install
5.6s avg
Import
Disk
61MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v3.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 61.8MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 5.6s · import 0.000s · 62MB
61MB installed
● package 61MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

add_paths
from static_ffmpeg import add_paths
from static_ffmpeg import FFmpeg
run
from static_ffmpeg import run
from static_ffmpeg import FFmpeg

Initialize and run ffmpeg commands with automatic binary download if not cached.

from static_ffmpeg import FFmpeg ff = FFmpeg() ff.execute(['-version']) # ff.execute(['-i', 'input.mp4', 'output.mp4'])
Debug
Known issues
gotchaFirst invocation downloads a large ffmpeg binary (~50-100MB). Ensure internet connectivity and sufficient disk space.
fix
Pre-download using static_ffmpeg.download() or set STATIC_FFMPEG_AUTO_DOWNLOAD=False to manage manually.
affects: all
gotchaThe execute() method expects a list of arguments, not a single string. Passing a string (e.g., '-i in.mp4 -out out.mp4') will break.
fix
Always pass a list: ff.execute(['-i', 'in.mp4', 'out.mp4'])
affects: all
deprecatedThe 'run()' method was renamed to 'execute()' in version 1.5. 'run()' still works but logs a deprecation warning.
fix
Use ff.execute() instead of ff.run().
affects: >=1.5
Upgrade
Version history
3.0latest on PyPI · released Jan 16, 2026
Audit
Dependencies
requestsrequiredUsed for downloading ffmpeg binary
Agent activity
47 hits · last 30 days
node
42
OpenAI (training)
1
Resources
static-ffmpeg — pip install static-ffmpeg · libregistry