Metadata-Version: 2.4
Name: ffmpeg-binaries
Version: 1.0.1
Summary: A static build of ffmpeg for Python
Author-email: Matteo Dell'Acqua <dellacqua.matteo99@gmail.com>
Maintainer-email: Matteo Dell'Acqua <dellacqua.matteo99@gmail.com>
Project-URL: MyHomepage, https://github.com/MatteoH2O1999/ffmpeg-binaries
Keywords: ffmpeg,static
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: patool
Dynamic: license-file

# ffmpeg for Python

[![CI/CD](https://github.com/MatteoH2O1999/ffmpeg-binaries/actions/workflows/ci.yml/badge.svg)](https://github.com/MatteoH2O1999/ffmpeg-binaries/actions/workflows/ci.yml)
[![codecov](https://codecov.io/github/MatteoH2O1999/ffmpeg-binaries/graph/badge.svg?token=9jkgMvjxxs)](https://codecov.io/github/MatteoH2O1999/ffmpeg-binaries)
![GitHub](https://img.shields.io/github/license/MatteoH2O1999/ffmpeg-binaries)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![PyPI Version](https://badge.fury.io/py/ffmpeg-binaries.svg)](https://pypi.org/project/ffmpeg-binaries/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ffmpeg-binaries)
[![Downloads](https://pepy.tech/badge/ffmpeg-binaries)](https://pepy.tech/project/ffmpeg-binaries)

Static builds of ffmpeg for Python

## Installation

From pip:

```commandline
pip install ffmpeg-binaries
```

## Basic usage

```python
import ffmpeg

# Initialize module (only if no binaries found)
ffmpeg.init()

# Call ffmpeg directly
ffmpeg.run_as_ffmpeg("-h")

# Use the binaries path in other modules
other_module.add_ffmpeg(ffmpeg.FFMPEG_PATH)

# Add directly to path
ffmpeg.add_to_path()
```

## Import name conflict

If another dependency aleady uses the `ffmpeg` import name, like [typed-ffmpeg](https://github.com/livingbio/typed-ffmpeg) or
[ffmpeg-python](https://github.com/kkroening/ffmpeg-python), you can install the mirror package instead:

```commandline
pip install ffmpeg-binaries-compat
```

and use it with the import name `ffmpeg_binaries`:

```python
import ffmpeg_binaries as ffmpeg

# Initialize module (only if no binaries found)
ffmpeg.init()

# Call ffmpeg directly
ffmpeg.run_as_ffmpeg("-h")

# Use the binaries path in other modules
other_module.add_ffmpeg(ffmpeg.FFMPEG_PATH)

# Add directly to path
ffmpeg.add_to_path()
```
