Build the project

PreparationCopy Anchor Link

1. Download the prebuilt libwebrtc.a from libwebrtc-builder and install it to /usr/local. To compile it yourself instead, follow BUILD_WEBRTC.

   Copy Text

   LIBWEBRTC_VERSION=7727
   wget https://github.com/mazupo/libwebrtc-builder/releases/download/${LIBWEBRTC_VERSION}/libwebrtc-arm64.tar.gz
   mkdir -p libwebrtc
   tar -xzf libwebrtc-arm64.tar.gz -C libwebrtc
   
   # Remove the headers of a previously installed version, if any
   sudo rm -rf /usr/local/include/webrtc
   sudo mkdir -p /usr/local/include/webrtc
   sudo cp -r libwebrtc/include/* /usr/local/include/webrtc/
   sudo cp libwebrtc/lib/libwebrtc.a /usr/local/lib/

2. Prepare the MQTT development library.
   • Follow BUILD_MOSQUITTO to compile mosquitto.
   • Install the lib from official repo [tutorial]. (recommended)
3. Install essential packages

   Copy Text

   sudo apt install cmake clang clang-format lld mosquitto-dev libboost-program-options-dev libavformat-dev libavcodec-dev libavutil-dev libswscale-dev libpulse-dev libasound2-dev libjpeg-dev libcamera-dev libmosquitto-dev

4. Install clang-20 and lld-20 (or newer versions). Set them as default using update-alternatives:

   Copy Text

   wget https://apt.llvm.org/llvm.sh
   chmod +x llvm.sh
   sudo ./llvm.sh 20
   sudo apt install lld-20 clang-format-20
   sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-20 100
   sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-20 100
   sudo update-alternatives --install /usr/bin/ld.lld ld.lld /usr/bin/ld.lld-20 100
   sudo update-alternatives --install /usr/bin/clang-format clang-format /usr/bin/clang-format-20 100

5. Install Protobuf compiler (protoc) v33.0 to match the protobuf bundled in libwebrtc.a.

   Copy Text

   # Download pre-built protoc v33.0 (adjust the URL for your architecture)
   # For arm64:
   curl -sLO https://github.com/protocolbuffers/protobuf/releases/download/v33.0/protoc-33.0-linux-aarch_64.zip
   
   unzip protoc-33.0-linux-aarch_64.zip -d protoc-33.0
   
   # Install protoc binary and well-known proto includes
   sudo cp protoc-33.0/bin/protoc /usr/local/bin/protoc
   sudo cp -r protoc-33.0/include/* /usr/local/include/
   
   # Verify installation
   protoc --version  # should print "libprotoc 33.0"

6. Copy the nlohmann/json.hpp to /usr/local/include

   Copy Text

   sudo mkdir -p /usr/local/include/nlohmann
   sudo curl -L https://raw.githubusercontent.com/nlohmann/json/develop/single_include/nlohmann/json.hpp -o /usr/local/include/nlohmann/json.hpp

Compile and runCopy Anchor Link

Build on raspberry pi and it'll output a pi-webrtc file in /build.

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Debug
make -j

Run pi-webrtc to start the service.

./pi-webrtc --camera=libcamera:0 --fps=30 --width=1280 --height=720 --use-mqtt --mqtt-host=<hostname> --mqtt-port=1883 --mqtt-username=<username> --mqtt-password=<password> --hw-accel