{"id":24654,"library":"static-ffmpeg","title":"static-ffmpeg","description":"Provides a static download of ffmpeg for cross-platform use, ensuring a consistent ffmpeg binary across different systems. Current version 3.0, updated irregularly.","status":"active","version":"3.0","language":"python","source_language":"en","source_url":"https://github.com/aminvs/static-ffmpeg","tags":["ffmpeg","cross-platform","binary","static"],"install":[{"cmd":"pip install static-ffmpeg","lang":"bash","label":"Install"}],"dependencies":[{"reason":"Used for downloading ffmpeg binary","package":"requests","optional":false}],"imports":[{"note":"FFmpeg is a class, not a module; direct import fails.","wrong":"import static_ffmpeg.FFmpeg","symbol":"FFmpeg","correct":"from static_ffmpeg import FFmpeg"}],"quickstart":{"code":"from static_ffmpeg import FFmpeg\nff = FFmpeg()\nff.execute(['-version'])\n# ff.execute(['-i', 'input.mp4', 'output.mp4'])","lang":"python","description":"Initialize and run ffmpeg commands with automatic binary download if not cached."},"warnings":[{"fix":"Pre-download using static_ffmpeg.download() or set STATIC_FFMPEG_AUTO_DOWNLOAD=False to manage manually.","message":"First invocation downloads a large ffmpeg binary (~50-100MB). Ensure internet connectivity and sufficient disk space.","severity":"gotcha","affected_versions":"all"},{"fix":"Always pass a list: ff.execute(['-i', 'in.mp4', 'out.mp4'])","message":"The execute() method expects a list of arguments, not a single string. Passing a string (e.g., '-i in.mp4 -out out.mp4') will break.","severity":"gotcha","affected_versions":"all"},{"fix":"Use ff.execute() instead of ff.run().","message":"The 'run()' method was renamed to 'execute()' in version 1.5. 'run()' still works but logs a deprecation warning.","severity":"deprecated","affected_versions":">=1.5"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'from static_ffmpeg import FFmpeg' then 'ff = FFmpeg()'.","cause":"Importing 'import static_ffmpeg' and then calling static_ffmpeg()","error":"TypeError: 'module' object is not callable"},{"fix":"Use static_ffmpeg.FFmpeg instead of subprocess calling 'ffmpeg'.","cause":"System ffmpeg not in PATH, but static_ffmpeg not used correctly","error":"FileNotFoundError: [Errno 2] No such file or directory: 'ffmpeg'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}