Repository files navigation

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.

importmpegCoder

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

1. Clone themaster branch which only contains the codes ofmpegCoder:

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

2. Install the pre-requisite packages. The following script could be used by ubuntu or debian. If users are using other Linux distribution, they should installgcc andg++ 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

3. 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 providea compiling script 📃 in the deps branch. You could download and build it by the following commands:

     mkdir -p /appschmod +rwx /appscurl -O https://raw.githubusercontent.com/cainmagi/FFmpeg-Encoder-Decoder-for-Python/deps/install-ffmpeg-5_0.shchmod +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 thesetup.py by

     FFMPEG_DIR='/apps/build/ffmpeg-5.0'

   • Download the pre-built dependencies. These dependencies are built by myself. You could download the archivehere 📦. The files need to be extracted to./dependencies:

     cd FFmpeg-Encoder-Decoder-for-Pythonmkdir -p dependencieswget -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 installurllib3. Thetqdm is also recommended to be installed.

4. BuildmpegCoder 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 thesetup.py may trigger an event for fetching the online dependencies.

   python setup.py build

5. Rename the built module asmpegCoder.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 downloadthe lib dependencies 📦 and add thelib folder to yourLD_LIBRARY_PATH:

   mkdir -p /apps/ffmpeg-5.0cd /apps/ffmpeg-5.0wget -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">>~/.bashrcexport LD_LIBRARY_PATH=/apps/ffmpeg-5.0/lib:$LD_LIBRARY_PATH

6. RunningmpegCoder requiresGLIBC>=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.31.so /lib/x86_64-linux-gnu/libm.so.6

Has been moved to📑 CHANGELOG.md

Current FFMpeg version is5.0.