cross-compiling.txt

******************************************************************************
***            Cross-compiling Avidemux on Linux for Windows               ***
***                                                                        ***
***          Description of the default build environment setup            ***
******************************************************************************


1. Install MXE (M cross environment) build dependencies as described in

    http://mxe.cc/#requirements

for your respective Linux distribution. For Fedora, at the time of writing,
this list doesn't mention the developer package for pcre (pcre-devel), needed
for a successful build of glib in MXE, see https://github.com/mxe/mxe/issues/2875
for the same omission fixed for Debian and its derivatives.

Once dependencies have been installed, run the script mxe-setup.sh from
a directory *outside of Avidemux top source directory*. This script will

  a) clone MXE git repository;

  b) create a source tarball of the latest x264 off the stable branch from
  the videolan.org x264 git mirror, generate and apply a patch for MXE;

  c) patch MXE to use more recent versions of the following codecs:
        fdk-aac: 2.0.0 --> 2.0.3
        libvpx:  1.8.2 --> 1.14.1
        opus:    1.3.1 --> 1.5.2
        x265:    2.4   --> 3.6

  d) build the 64-bit MXE target (the 32-bit target is currently untested);

  e) clone libaom git repository from googlesource.com, build and install
  the library in both MXE targets;

  d) install the sdk/11.1 branch of nv-codec-headers from the mirror at GitHub
  in the 64-bit MXE target only.

The absolute path to the "mxe" directory created during this step is referenced
below as ${MXE_ROOT}.

An example for the case that Avidemux source was cloned as ~/avidemux2:

    cd ~ && mkdir cross-build && cd cross-build && bash ../avidemux2/mxe/mxe-setup.sh

##############################################################################

2. Enter the Avidemux top source directory and run

    bash bootStrapCrossMingwQt5_mxe.sh --mxe-root=${MXE_ROOT}

to cross-compile a 64-bit Avidemux version. If 32-bit MXE target has been
built, run

    bash bootStrapCrossMingwQt5_mxe.sh --mxe-root=${MXE_ROOT} --32

to cross-compile a 32-bit version. Run

    bash bootStrapCrossMingwQt5_mxe.sh -h

to see the list of all available options. It is assumed that 'zip' utility is
installed and in $PATH. Copy the 'avidemux_rYYMMDD-hhmmss_win{32,64}Qt5.zip'
file from the 'packaged_mingw_build_YYMMDD-hhmmss' directory to a Windows
partition, extract it on Windows and run 'avidemux.exe' from there.

##############################################################################

3. Issues:

Build of the mesa package in MXE was observed failing with python3 >= 3.8.
As a workaround, make sure that python2 is installed and unversioned python
command points to python2. See https://bugs.python.org/issue40350
The issue seems to be resolved at least in Fedora 40 (python3 >= 3.12.4) as
host Linux distribution.

As of this writing, twolame, aften, vapoursynth and avsproxy are not available.

2024-08-12