Installation

Prerequisites

MediaX requires the following dependencies:

  • GCC 9+ or Clang 10+ with C++17 support
  • CMake 3.16+
  • GStreamer 1.16+ (optional, for H.264/H.265)
  • Qt6 (optional, for Qt bindings)

Quick Install (Ubuntu)

Run the provided setup script to install all dependencies:

sudo ./scripts/init_build_machine.sh

Manual Dependencies

Ubuntu 22.04 / 24.04

sudo apt-get update
sudo apt-get install -y \
    build-essential cmake \
    libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
    libswscale-dev libgflags-dev \
    libgtest-dev libgmock-dev \
    swig python3-dev

For Qt6 Support

sudo apt-get install -y qt6-base-dev qt6-multimedia-dev

For Intel VAAPI (Hardware Acceleration)

sudo apt-get install -y libva-dev intel-media-va-driver

Installing from Packages

Pre-built Debian packages are available:

# Runtime library
sudo dpkg -i mediax_<version>_<arch>.deb

# Development headers
sudo dpkg -i mediax-dev_<version>_<arch>.deb

# Python bindings
sudo dpkg -i mediax-python_<version>_<arch>.deb

Verifying Installation

pkg-config --modversion mediax

Next Steps

Support

Need help with installation?