FAQ

FAQ & Known Limitations

Answers to the recurring questions that show up across the jocover and Keylost trackers, plus what this fork fixes and adds. Each entry follows symptom → cause → resolution/workaround → references, and cites the upstream issues so searchers land here.

Sourced from the 237-fork network sweep — see Fork Network Overview, the full report, and the cross-referenced results.

Sections

Page	Covers
Hardware & Platform Limits	4K encode cap, Orin Nano has no NVENC, mod-16 alignment, VP8 availability
Versions & Compatibility	Supported FFmpeg 4.2→8.0 matrix, HEVC-over-RTMP needs ≥ 6.1
Build & Install	pkg-config "nvmpi not found", glibc ≥ 2.34 segfault, Ubuntu 22.04
Performance	WITH_NVUTILS CPU delta, max-perf-mode speedup, long-decode CPU rise, pool sizing
Features & Fork Differences	What this fork fixed vs jocover/Keylost, and the roadmap

Quick answers

• "Which FFmpeg versions are supported?" → 4.2, 4.4, 6.0, 6.1, 7.0, 7.1, 8.0. See Compatibility.
• "Can the Orin Nano encode?" → No NVENC silicon; decode-only. Details.
• "Encode above 4K fails." → NVENC hardware cap, not software-fixable. Details.
• "pkg-config can't find nvmpi." → PKG_CONFIG_PATH + ldconfig. Details.
• "Segfault on Ubuntu 22.04 / glibc ≥ 2.34." → fixed in this fork. Details.
• "How do I use hardware MJPEG decode?" → ffmpeg -c:v mjpeg_nvmpi -i input.mjpeg .... Baseline JPEG only; progressive is rejected. Details.

MJPEG Decoder

How do I use hardware MJPEG decode?

Use the mjpeg_nvmpi decoder:

ffmpeg -c:v mjpeg_nvmpi -i input.mjpeg -c:v libx264 output.mp4

The decoder handles baseline JPEG only. Progressive JPEG (SOF2) is rejected with an error — the NVJPG engine does not support it.

Why is MJPEG decode quality slightly different from software?

The hardware path goes through a VIC (Video Image Compositor) transform to convert from block-linear to pitch-linear format. This introduces minor color-space rounding differences compared to pure software libjpeg decode. PSNR is typically ~28 dB — visually identical for all practical purposes.

Orin Nano MJPEG performance

The NVJPG engine clock on Orin Nano defaults to 115 MHz (pre-JetPack 5.1.2). For maximum MJPEG decode throughput, run sudo jetson_clocks or configure nvpmodel to boost the NVJPG clock.