Troubleshooting and FAQ

Common Issues

FFmpeg not in PATH
- Install FFmpeg and ensure it is on your PATH.
OpenCV lacks GStreamer
- Rebuild OpenCV with -D WITH_GSTREAMER=ON. See Build Guide: OpenCV with GStreamer.
VMAF filters missing in ffmpeg
- Build/install libvmaf, then rebuild FFmpeg with --enable-libvmaf. See Build Guide: FFmpeg with VMAF.
PCAP decode artifacts
- Check RTP ordering, payload type, packet loss. Validate in Wireshark.
Python dependency conflicts
- Use separate venvs (e.g., 3.8 for generation, 3.12.2 for metrics).
Frame mismatch during metrics
- Verify synchronization, frame counts, and dimensions.

Ensure a server/<Game>/ folder exists when config.yaml sets Running:game to that name.
The game folder must contain frames in sequential order.
Create logs folders in both player/ and server/ directories.

Missing tools (e.g., nasm, meson, ninja): install via apt.
If Meson/Ninja build fails for libvmaf, set up a Python venv and rerun Meson as per error hints.
Run sudo ldconfig after installing libraries.