FFmpeg-Encoder-Decoder-for-Python

This is a mpegCoder adapted from FFmpeg & Python-c-api. Using it you could get access to processing video easily. Just use it as a common module in python like this.

import mpegCoder

Branch	Description
`master` 🔗	The source project of `mpegCoder`, Windows version.
`master-linux` 🔗	The source project of `mpegCoder`, Linux version.
`example-client-check` 🔗	A testing project of the online video stream demuxing.
`example-client-player` 🔗	A testing project of the simple online video stream player.

Source project of `mpegCoder` (Linux)

The following instructions are used for building the project on Windows with Visual Studio 2019.

Clone the master branch which only contains the codes of mpegCoder:

git clone --single-branch -b master-linux https://github.com/cainmagi/FFmpeg-Encoder-Decoder-for-Python.git

Install the pre-requisite packages. The following script could be used by ubuntu or debian. If users are using other Linux distribution, they should install gcc and g++ by themselves.
```
chmod +rwx ./apt-requirements.sh
./apt-requirements.sh
```
We strongly suggest that users should also install the python dependencies (optional):
```
python -m pip install -r requirements.txt
```
Get the shared version of the Linux FFMpeg. We support three different approaches for this step:
- Build the shared libs of FFMpeg from the source codes by yourself. We provide a compiling script 📃 in the deps branch. You could download and build it by the following commands:
```
mkdir -p /apps
chmod +rwx /apps
curl -O https://raw.githubusercontent.com/cainmagi/FFmpeg-Encoder-Decoder-for-Python/deps/install-ffmpeg-5_0.sh
chmod +rwx install-ffmpeg-5_0.sh
./install-ffmpeg-5_0.sh --all --nvcuda
```
  After running this script, the FFMpeg with most of the dependencies would be complied along with the shared libraries. Then you could replace the FFMpeg path in the setup.py by
```
FFMPEG_DIR = '/apps/build/ffmpeg-5.0'
```
- Download the pre-built dependencies. These dependencies are built by myself. You could download the archive here 📦. The files need to be extracted to ./dependencies:
```
cd FFmpeg-Encoder-Decoder-for-Python
mkdir -p dependencies
wget -O- https://github.com/cainmagi/FFmpeg-Encoder-Decoder-for-Python/releases/download/deps-3.2.0/dep-linux-ffmpeg_5_0.tar.xz | tar xJ -C "./dependencies"
```
- The dependencies could be also downloaded by the automatic script, you just need to run
```
python webtools.py
```
  This script requires users to install urllib3. The tqdm is also recommended to be installed.
Build mpegCoder by running the following script. The built file would be stored in ./build. If you has not fetched the dependencies in the step 2, running the setup.py may trigger an event for fetching the online dependencies.
```
python setup.py build
```

Rename the built module as mpegCoder.so, then you could import it in the same directory. If you have built FFMpeg by our script, you do not need any other dependencies when importing the libs. However, if not, you may need to download the lib dependencies 📦 and add the lib folder to your LD_LIBRARY_PATH:

mkdir -p /apps/ffmpeg-5.0
cd /apps/ffmpeg-5.0
wget -O- https://github.com/cainmagi/FFmpeg-Encoder-Decoder-for-Python/releases/download/deps-3.2.0/so-linux-ffmpeg_5_0.tar.xz | tar xJ -C "."
echo "export LD_LIBRARY_PATH=/apps/ffmpeg-5.0/lib:\$LD_LIBRARY_PATH" >> ~/.bashrc
export LD_LIBRARY_PATH=/apps/ffmpeg-5.0/lib:$LD_LIBRARY_PATH

Running mpegCoder requires GLIBC>=2.29. This requirement is not satisfied in some cases. However, if you have built FFMpeg by our script, the requirement would be fulfilled (i.e. you could skip this step). If users are using our pre-built dependencies, users may need to solve this problem by
```
ln -sf /apps/ffmpeg-5.0/lib-fix/libm-2.35.so /lib/x86_64-linux-gnu/libm.so.6
```

Update reports

Has been moved to 📑 CHANGELOG.md

Version of currently used FFmpeg library

Current FFMpeg version is 5.0.

Dependency	Version
`libavcodec`	`59.18.100.0`
`libavformat`	`59.16.100.0`
`libavutil`	`57.17.100.0`
`libswresample`	`4.3.100.0`
`libswscale`	`6.4.100.0`

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!