Build guide for Windows

April 7, 2026 ยท View on GitHub

Requirements

  • Windows Server 2025

Prepare build environment

  1. Install MSYS2

    Download the latest installer from https://www.msys2.org/

  2. Install npcap

    Download the latest installer from https://npcap.com/#download

  3. Run MSYS2 UCRT64

    Note: All the following commands should be executed in UCRT64 environment.

  4. Install tools

    pacman -S git pactoys unzip

    pacboy -S dlfcn:p gcc:p gtest:p json-c:p libpcap:p meson:p mman-win32:p

  5. Install npcap SDK

    wget https://npcap.com/dist/npcap-sdk-1.16.zip

    unzip -d npcap-sdk-1.16 ./npcap-sdk-1.16.zip

    cp -r ./npcap-sdk-1.16/lib/x64/. "${MSYSTEM_PREFIX}/lib"

Build DPDK

  1. Clone the MTL repository

    git clone https://github.com/OpenVisualCloud/Media-Transport-Library.git

    cd ./Media-Transport-Library

    MTL_PATH="$PWD"

  2. Clone the DPDK repository

    Note: The DPDK repository should be located directly in the MTL repository.

    git clone -b v25.11 https://github.com/DPDK/dpdk.git

  3. Apply the MTL patches for DPDK

    cd "${MTL_PATH}/dpdk"

    git am "$MTL_PATH"/patches/dpdk/25.11/*.patch

    git apply "$MTL_PATH"/patches/dpdk/25.11/windows/*.patch

  4. Build DPDK

    meson setup -Dmax_lcores=256 build

    meson compile -C build

    Create a copy of the sched.h file

    Note: DPDK installation overwrites the sched.h file and cause MTL build problems

    cp "${MSYSTEM_PREFIX}/include/sched.h" "${MTL_PATH}/sched.h.bak"

    meson install -C build

    Restore the copy

    cp "${MTL_PATH}/sched.h.bak" "${MSYSTEM_PREFIX}/include/sched.h"

Build MTL

  1. Run the build script

    cd "$MTL_PATH"

    ./build.sh debugonly