From 13a40f973308bfc72be64b29a3f13fe7e9fb4104 Mon Sep 17 00:00:00 2001 From: VallierDev <24893073+VallierDev@users.noreply.github.com> Date: Sat, 14 Nov 2026 20:19:40 +0800 Subject: [PATCH] docs: note NVENC API mismatch on Pascal with FFmpeg 9 (#230) Co-Authored-By: Claude Opus 5.5 --- README.en.md | 1 + README.md | 1 + 2 files changed, 2 insertions(+) diff --git a/README.en.md b/README.en.md index 279d848..3d63505 100644 --- a/README.en.md +++ b/README.en.md @@ -231,6 +231,7 @@ sudo apt install libpulse-dev libopus-dev - `libgtk-3-dev` is optional. Without GTK, login works with a QR code in the terminal (`UU_NO_GTK=1` disables the login window explicitly). - On NVIDIA GPUs use an FFmpeg build with `h264_nvenc`; otherwise the CPU encoder (libx264) is used. +- The NVENC API version FFmpeg requires comes from the nv-codec-headers it was built against. For example, Arch's FFmpeg 9 is built against nv-codec-headers 13.1 and needs driver 610 or newer; Pascal (GTX 10 series) tops out at driver 580 with NVENC API 13.0, so the log shows `Driver does not support the required nvenc API version` and encoding falls back to the CPU. Build a separate FFmpeg against nv-codec-headers 13.0 into its own prefix and point `ffmpeg_root` in `config.json` at it (#230). ### 2. Build diff --git a/README.md b/README.md index 2451342..e6e96e3 100644 --- a/README.md +++ b/README.md @@ -209,6 +209,7 @@ sudo apt install libpulse-dev libopus-dev - 需要 Rust 工具链()。 - `libgtk-3-dev` 是可选的:没有 GTK 时只能在终端里扫码登录(也可以设置 `UU_NO_GTK=1` 主动关闭登录窗口)。 - NVIDIA 显卡用户需要使用带 `h264_nvenc` 的 FFmpeg,否则自动回落到 CPU 编码(libx264)。 +- FFmpeg 要求的 NVENC API 版本由编译时的 nv-codec-headers 决定。例如 Arch 的 FFmpeg 9 对着 nv-codec-headers 13.1 编译,需要 610 及以上驱动;Pascal(GTX 10 系)驱动最高 580,只有 NVENC API 13.0,日志会出现 `Driver does not support the required nvenc API version`,于是回落 CPU。可对着 nv-codec-headers 13.0 另编一份 FFmpeg 装到独立目录,在 `config.json` 里用 `ffmpeg_root` 指向它(#230)。 ### 2. 编译