Skip to main content

A simple asynchronous Python wrapper for ffmpeg

Project description

Latest version Travis-CI Documentation Status


ffmpy3 is a fork of ffmpy, a simplistic FFmpeg command line wrapper. ffmpy implements a Pythonic interface for executing FFmpeg via command line and uses Python’s subprocess module for synchronous execution. Asynchronous execution using yield from or await is also supported using Python’s asyncio.subprocess module.


You guessed it:

pip install ffmpy3

Quick example

The following code snippet executes FFmpeg synchronously, taking input.mp4 from the current directory as the input. It remuxes the contents of input.mp4 into a new file called output.avi which is saved in the current directory.

>>> import ffmpy3
>>> ff = ffmpy3.FFmpeg(
...     inputs={'input.mp4': None},
...     outputs={'output.avi': None}
... )

The following code snippet does the same thing as above, but executes FFmpeg asynchronously.

>>> ff = ffmpy3.FFmpeg(
...     inputs={'input.mp4': None},
...     outputs={'output.avi': None}
... )
>>> ff.run_async()
>>> await ff.wait()


See Examples section for usage examples.


ffmpy3 is licensed under the terms of the MIT license.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ffmpy3-0.2.4.tar.gz (5.7 kB view hashes)

Uploaded source

Built Distribution

ffmpy3-0.2.4-py3-none-any.whl (6.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page