| MainConcept AVC Decoder Plug-in for FFmpeg 3.3.0

Loading...
Searching...
No Matches
Installation

To use the MainConcept plug-in for FFmpeg, you must have a compatible configuration.

# System requirements

To use the MainConcept plug-ins for FFmpeg, you must have a compatible configuration.

## Supported operating systems

- Microsoft Windows 10 or Windows 11 (64-bit, x86 only)
- Linux x86 Ubuntu 20.04 LTS (glibc 2.31), Rocky Linux 8 (glibc 2.28)
- Linux ARM Ubuntu 20.04 glibc 2.31 (64-bit)

## Software requirements

MainConcept modified versions of FFmpeg (see available download below):

- FFmpeg 4.4 "Rao"
- FFmpeg 6.0 "Von Neumann"
- FFmpeg 7.0 "Dijkstra"

To run the MainConcept plug-in for FFmpeg, the following software packages must be installed in this order:

1. A modified FFmpeg version (FFmpeg 4.4, 6.0 or 7.0) as ready-to-use binary or as source code that you must compile yourself. The binaries can be found on the MainConcept website: https://www.mainconcept.com/ffmpeg. The source code of both modified FFmpeg versions is publicly available on GitHub: https://github.com/MainConcept/mc-ffmpeg-omx
2. To test the plug-in, download the appropriate free MainConcept plug-in for FFmpeg Demo version installer from the MainConcept website: https://www.mainconcept.com/. This works for FFmpeg 4.4, 6.0 and 7.0.
3. For a plug-in that is already licensed, install the full version of the appropriate MainConcept plug-in for FFmpeg after purchase. This works for FFmpeg 4.4, 6.0 and 7.0.

After installation, the FFmpeg plug-in documentation can be found here:

- Windows:

      C:\Program Files\MainConcept\FFmpeg-PlugIns\doc

- Linux:

      \opt\mainconcept\omx\share\doc\

Note
  The demo version of the MainConcept video plug-ins for FFmpeg is fully functional. Only a watermark is added to the processed video.

# Installation on Windows

To run the MainConcept plug-in for FFmpeg on Windows, the following software packages must be installed in this order:

1. Install modified FFmpeg
2. Install the demo version of the MainConcept plug-in for FFmpeg
3. Install the fully licensed version of the MainConcept plug-in for FFmpeg (optional)

## Modified FFmpeg and demo plug-in installation on Windows

You first need to install the required FFmpeg version for the MainConcept FFmpeg plug-in on your system by completing the steps below:

1. Run the ffmpeg_static_4.4-omx_win64_2.3.0.exe installer file to launch the installation wizard. In the Welcome dialog, select Next to proceed.
2. When the license agreement (EULA) appears on the screen, review it carefully. Select I Agree to accept the terms. If you do not agree, the installation process will be aborted.
3. You will then be asked for the destination folder to which FFmpeg should be installed. We recommend using the default location. Note that you must also install the MainConcept plug-in demo version or full version to this folder later. Select Next to proceed.
4. You can also choose a Start Menu folder. We recommend using the default location. Select Next to proceed.
5. The installation will now begin and an indicator will display the installation progress.
6. When the next dialog appears, select Finish to complete the setup.

FFmpeg is now installed on your computer.

You must now install the demo version of the MainConcept plug-in for FFmpeg for evaluation. You must install it to the same location where you previously installed FFmpeg:

1. Run the mainconcept_ffmepg_plugins_demo installer file to launch the installation wizard. In the Welcome dialog, select Next to proceed.
2. When the license agreement (EULA) appears on the screen, review it carefully. Select I Agree to accept the terms. If you do not agree, the installation process will be aborted.
3. You will then be asked for the destination folder. However, the demo version of the MainConcept FFmpeg plug-in must be installed to the same folder where FFmpeg was previously installed. Select Next to proceed.
4. You can also choose a Start Menu folder. We recommend using the default location. Select Next to proceed.
5. The installation will now begin. An indicator will display the installation progress.
6. When the next dialog appears, select Finish to complete the setup.

The demo version of the MainConcept plug-in for FFmpeg is now installed on your computer and you can now start to evaluate the software.

## Full version installation on Windows

Note
  mainconcept_avc_decoder_plugin_full is the correct installer file to launch when installing the full version of the MainConcept AVC/H.264 Decoder plug-in.

This section describes how to install the fully licensed version of the MainConcept plug-in for FFmpeg when you already own a valid license after purchase. It must be installed to the same location to which you previously installed FFmpeg.
If you have not yet installed modified FFmpeg, first complete the steps outlined under Modified FFmpeg and demo plug-in installation on Windows.

1. Run the appropriate installer file mentioned in the note above to launch the installation wizard. In the Welcome dialog, select Next to proceed.
2. When the license agreement (EULA) appears on the screen, review it carefully. Select I Agree to accept the terms. If you do not agree, the installation process will be aborted..
3. You will then be asked for the destination folder. The plug-in must be installed to the same folder to which FFmpeg was previously installed. Select \ Next to proceed.
4. You can also choose a Start Menu folder. We recommend using the default location. Select Next to proceed.
5. In the next dialog, select Finish to complete the setup.

The MainConcept plug-in for FFmpeg is now installed on your computer. You must now activate the licensed version of the software before it can be used.

# Uninstall on Windows

This section describes how to uninstall the MainConcept plug-in for FFmpeg. The uninstall process must be run from the same location where you previously installed FFmpeg:

    C:\Program Files\MainConcept\FFmpeg-PlugIns

To uninstall the MainConcept plug-in for FFmpeg on Windows, you must run the uninstaller for the following software packages:

1. Modified version of FFmpeg
2. Demo or fully-licensed version of the MainConcept plug-in for FFmpeg

Run the appropriate uninstaller file:

1. From the Welcome dialog, select Next to proceed.
2. You will then be shown the installation folder. Select Uninstall to proceed.
3. From the dialog that follows, select Finish to complete the uninstall.

The MainConcept plug-in for FFmpeg is now uninstalled from your computer.

# Installation on Linux

To run the MainConcept plug-in for FFmpeg on Debian-based Linux, the following software packages must be installed in this order:

- Install modified FFmpeg
- Install the demo version of the MainConcept plug-in for FFmpeg
- Install the fully licensed MainConcept plug-in for FFmpeg (optional)

## Modified FFmpeg and demo plug-in installation on Linux

As an initial package, you must install the MainConcept modified version of FFmpeg that enables the MainConcept FFmpeg plug-ins:

1. Unpack the downloaded package and run the self-extracting executable and accept the EULA:
   tar xf mc_ffmpeg_installer_gcc_linux64_x64_<version_id>.tar.bz2
   ./ffmpeg_static_4.4-omx_linux64_2.3.0.run
2. Install the package file according to your Linux-based system:
   Debian-based Linux
   sudo dpkg -i ffmpeg_omx/deb/ffmpeg-static_4.4-0omx.0~3992_amd64.deb
   RPM-based Linux
   sudo yum localinstall ffmpeg_omx/rpm/ffmpeg-static-4.4-0omx.0.3992.el7.x86_64.rpm
3. Verify that the MainConcept modified FFmpeg is correctly installed by calling FFmpeg from the installation folder:
   /opt/mainconcept/ffmpeg-omx/bin/ffmpeg
   ffmpeg version n4.4-456-g7af8b3b Copyright (c) 2000-2019 the FFmpeg developers built with gcc 4.8.5 (GCC) 20150623 (Red Hat 4.8.5-39) configuration: --disable-ffplay --disable-doc --enable-static --disable-shared --disable-debug --enable-asm --cc=gcc --enable-x86asm --enable-omx --enable-omx_enc_avc --enable-omx_enc_hevc --enable-omx_enc_xheaac --extra-cflags=-I../omxil_common/include/omx --prefix=../dist/linux-x64

Note
  You should see output similar to the following: `–enable-omx –enable-omx_enc_avc –enable-omx_enc_hevc –enable-omx_enc_xheaac`

FFmpeg is now installed on your computer.

You must now install the demo version of the MainConcept plug-in for FFmpeg for evaluation:

1. Unpack the demo plug-in tarball, then run the self-extracting executable and accept the EULA:
   tar xf mc_ffmpeg_plugins_demo_installer_gcc_linux64_x64_sfx-<build_id>.tar.bz2
   ./mainconcept_ffmpeg_plugin_linux64_demo_<version_id>.run

2. Install the package files according to your Linux-based system:
   Debian-based Linux

   cd mc_ffmpeg_plugins/deb/
   sudo dpkg -i -f mcomx-core_<version_id>_amd64.deb
   sudo dpkg -i -f mcomx-decavc_<version_id>_amd64.deb
   sudo dpkg -i -f mc-decavc-demo_<version_id>_amd64.deb
   sudo dpkg -i -f mc-sdk-conf_<version_id>_amd64.deb

   Alternatively, you can install all at once:

   sudo dpkg -i *.deb

   RPM-based Linux

   cd mc_ffmpeg_plugins/rpm/
   sudo yum localinstall mcomx-core_<version_id>.x86_64.rpm
   sudo yum localinstall mcomx-decavc_<version_id>.x86_64.rpm
   sudo yum localinstall mc-decavc-demo_<version_id>.x86_64.rpm
   sudo yum localinstall mc-sdk-conf_<version_id>.x86_64.rpm

   Alternatively, you can install all at once:

   sudo yum localinstall *

The demo version of the MainConcept plug-in for FFmpeg is now installed on your computer and you can now start evaluating the software.

## Full version installation on Linux

To install the fully licensed version of the MainConcept plug-in for FFmpeg, you must first install the modified FFmpeg version as described under Modified FFmpeg and demo plug-in installation on Linux and then complete the following steps:

1. Unpack the full version plug-in tarball, then run the self-extracting executable and accept the EULA:

   tar xf mc_ffmpeg_plugin_avc_decoder_installer_gcc_linux64_x64_sfx-installer4_b4003.tar.bz2
   ./mainconcept_avc_decoder_plugin_linux64_full_2.3.0.run

2. Install the package files according to your Linux-based system:
   Debian-based Linux

   sudo dpkg --force-depends -i codemeter_7.0.3918.500_amd64.deb
   sudo dpkg -i mc-decavc_<version_id>_amd64.deb

   We recommend using the full WIBU runtime installer described above. However, if you require a CLI-only version, you can alternatively install the lite version as described below and follow the section 1.10 CMU - CodeMeter Universal Support Tool in the WIBU CodeMeter Administrator Manual from here:

   sudo dpkg --force-depends -i codemeter-lite_7.0.3918.500_amd64.deb

   RPM-based Linux

   cd mc_ffmpeg_plugins/rpm/
   sudo yum localinstall mcomx-core_<version_id>.x86_64.rpm
   sudo yum localinstall mcomx-lic_<version_id>.x86_64.rpm
   sudo yum localinstall mcomx-decavc_<version_id>.x86_64.rpm
   sudo yum localinstall mc-decavc_<version_id>.x86_64.rpm
   sudo yum localinstall mc-sdk-conf_<version_id>.x86_64.rpm

   We recommend using the full WIBU runtime installer described above. However, if you require a CLI-only version, you can alternatively install the lite version as described below and follow the section 1.10 CMU - CodeMeter Universal Support Tool in the WIBU CodeMeter Administrator Manual from here:

   sudo yum localinstall codemeter-lite_7.0.3918.500_amd64.deb

The MainConcept plug-in for FFmpeg is now installed on your computer.

Note
  Once installation is complete, you must activate your license for the plug-in before you can use it. See License activation.

# Uninstall on Linux

This section describes how to uninstall the MainConcept plug-in for FFmpeg.

To remove the MainConcept plug-in for FFmpeg on Linux, you must uninstall the following software packages:

1. Modified version of FFmpeg can be uninstalled using the following command, depending on which Linux-based system you are using:
   Debian-based Linux
   sudo dpkg --purge --force-depends ffmpeg-omx.x86_64
   RPM-based Linux
   sudo rpm -e --nodeps ffmpeg-omx.x86_64
2. Demo or fully-licensed version of the MainConcept plug-in for FFmpeg can be uninstalled using the following command, depending on which Linux-based system you are using:
   Debian-based Linux
   sudo dpkg --purge --force-depends package_name
   RPM-based Linux
   sudo rpm -e --nodeps package_name
   The MainConcept plug-in for FFmpeg is now uninstalled from your computer.