OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
gpu-drivers medium occasional DISPUTE

Screen recording never starts on a Pascal NVIDIA card: 'Driver does not support the required nvenc API version. Required: 13.1 Found: 13.0'

omarchyarchhyprlandwaylandnvidiadesktoplaptopgpu-screen-recorderffmpegkdenlive
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Re-read issue omacom/omarchy#7217 in full with all five comments today, and it supports the record. The reporter's debug log carries both h264_nvenc lines and gsr error: Could not open video codec: Function not implemented on a GTX 1070 Ti with nvidia-580xx-dkms 580.178.04 and gpu-screen-recorder 6.0.0-1, the recorder's author (dec05eba) states that ffmpeg 9.0 raised the minimum NVENC version to 13.1 and that he added the ffmpeg version check in 6.0.1, and ritechoice23 reproduces the identical two lines out of Kdenlive through the system ffmpeg 2:9.0.1-1 on a Quadro P1000. I verified the mechanism in ffmpeg's source rather than accepting it from the thread: libavcodec/nvenc.c on release/9.0 compares NVENCAPI_MAJOR_VERSION/NVENCAPI_MINOR_VERSION against the driver's reported maximum, logs exactly the Driver does not support the required nvenc API version line and returns AVERROR(ENOSYS), and its nvenc_print_driver_requirement maps API 13.1 to minimum driver 610.00. nv-codec-headers declares NVENCAPI_MAJOR_VERSION 13 and NVENCAPI_MINOR_VERSION 1, which is what ffmpeg 9 is built against. Confirmed on this machine: line 191 of /usr/share/omarchy/bin/omarchy-capture-screenrecording passes -fallback-cpu-encoding yes and is byte-identical at tag v4.0.3 and at quattro HEAD, the script exposes no way to inject extra recorder arguments (only OMARCHY_SCREENRECORD_DIR, OMARCHY_SCREENRECORD_USE_PORTAL and OMARCHY_SCREENRECORD_DEBUG), omarchy screenrecord is a real alias declared in the script header, the debug log path /tmp/omarchy-screenrecord.log is the one the script writes, and gpu-screen-recorder --help on the installed 6.0.1-1 lists -w, -encoder gpu|cpu, -fallback-cpu-encoding yes|no, -f and -o, so the workaround command is valid as written. Two claims were wrong. The record says the author made -Dffmpeg_static=true the default for later releases, but the upstream README fetched today still documents that option as disabled by default and Arch's PKGBUILD for 6.1.1 passes -Dffmpeg_static=false, so no Arch or Omarchy package restores NVENC on Pascal and the CPU fallback is the only relief. And the version history is stale: extra shipped 6.0.1-1 on 2026-08-20, 6.0.2-1 on 2026-08-29, 6.1.0-1 on 2026-09-01 rather than 2026-09-02, and 6.1.1-1 on 2026-09-10, which is what extra carries now (this workstation still has 6.0.1-1). The Pascal driver claim holds and is now cited: the Arch wiki driver table puts Maxwell, Pascal and Volta on AUR nvidia-580xx-dkms, marked legacy and supported. Not exercised: this workstation runs nvidia-open-dkms 610.57.04, so the API floor cannot be hit here and neither the failure nor the CPU fallback was reproduced.

The cause above was rewritten on 2026-09-11 to match this note; the fix was corrected by the audit itself.

Symptom

omarchy screenrecord (every variant: fullscreen, region, with or without audio or webcam) does nothing. The bar's recording indicator never turns on and no file appears in ~/Videos. With OMARCHY_SCREENRECORD_DEBUG=true set, /tmp/omarchy-screenrecord.log ends with:


gsr info: using h264 encoder because a codec was not specified
[h264_nvenc @ 0x557b3650a880] ignoring invalid SAR: 0/0
[h264_nvenc @ 0x557b3650a880] Driver does not support the required nvenc API version. Required: 13.1 Found: 13.0
[h264_nvenc @ 0x557b3650a880] The minimum required Nvidia driver for nvenc is 610.00 or newer
gsr error: Could not open video codec: Function not implemented

Reported on Omarchy 4.0.0-1 with a GeForce GTX 1070 Ti on nvidia-580xx-dkms 580.178.04 and gpu-screen-recorder 6.0.0-1. A second reporter hit the same two h264_nvenc lines from Kdenlive's NVENC export presets on a Quadro P1000 with the same driver, and the same message comes from any program that encodes through the system ffmpeg.

Cause

Named by the gpu-screen-recorder author in the thread and checked against ffmpeg's own source. ffmpeg 9.0 is built against nv-codec-headers that declare NVENC API 13.1, and libavcodec/nvenc.c refuses to open the encoder when the driver reports a lower maximum version, returning AVERROR(ENOSYS), which surfaces as Could not open video codec: Function not implemented. The same function maps API 13.1 to a minimum driver of 610.00, which is where that second log line comes from. Pascal cards (GTX 10 series, Quadro P series) are stuck on the legacy nvidia-580xx branch, which reports API 13.0 only, and that branch is packaged in the AUR rather than in Arch's repositories, while extra/nvidia-utils is 610.57.04 and does not cover Pascal. omarchy-capture-screenrecording passes -fallback-cpu-encoding yes to gpu-screen-recorder (line 191 of the script, identical on this machine, at tag v4.0.3 and on quattro), but before 6.0.1 that option only checked whether the GPU supports NVENC, not whether ffmpeg accepts the driver's API version, so the recorder died opening the codec instead of falling back to software encoding. The author added an ffmpeg NVENC version check in gpu-screen-recorder 6.0.1 so the fallback fires. He also described making the -Dffmpeg_static=true build option (a bundled ffmpeg patched to negotiate the NVENC API at runtime) the default, but that is not what Arch ships: the upstream README still documents the option as disabled by default, and Arch's PKGBUILD for 6.1.1 passes -Dffmpeg_static=false and links the system ffmpeg. So on Omarchy the recording falls back to the CPU rather than regaining NVENC. Programs that use the system ffmpeg, such as Kdenlive, mpv and OBS, are not helped by either change.

Fix

  1. Check the recorder version. 6.0.1 or newer carries the fallback fix, so recording starts and encodes on the CPU instead of failing outright. On Omarchy 4 update through the supported path:

pacman -Q gpu-screen-recorder    # 6.0.0-1 is affected, 6.0.1-1 or newer has the fallback
omarchy update

On plain Arch, sudo pacman -Syu. Arch's extra repository shipped 6.0.1-1 on 2026-08-20, 6.0.2-1 on 2026-08-29, 6.1.0-1 on 2026-09-01 and 6.1.1-1 on 2026-09-10. No Arch build gives a Pascal card NVENC back: the PKGBUILD passes -Dffmpeg_static=false, so the package uses the system ffmpeg 9 and its API 13.1 floor still applies. The CPU fallback is the whole of the relief available here.

  1. Until the update lands, or if it still fails, force software encoding when calling the recorder directly. The Omarchy wrapper has no option for this, so run gpu-screen-recorder yourself. Replace DP-2 with your monitor name from hyprctl monitors:

gpu-screen-recorder -w DP-2 -encoder cpu -f 60 -o ~/Videos/recording.mp4
# stop with Ctrl+C, or from another terminal:
pkill -SIGINT -f gpu-screen-recorder

The reporter confirmed -encoder cpu produces a valid clip on the same card and driver.

  1. Kdenlive, mpv, OBS and anything else that uses the system ffmpeg cannot use NVENC on a Pascal card with ffmpeg 9 at all. Pick a software encoder (x264 or x265) in those programs. No driver available through Arch changes this: the Arch wiki's driver table puts Maxwell, Pascal and Volta on the AUR nvidia-580xx-dkms branch, and the newer extra/nvidia-utils 610.57.04 that reports API 13.1 does not support those cards.

Verify


pacman -Q gpu-screen-recorder            # 6.0.1-1 or newer
OMARCHY_SCREENRECORD_DEBUG=true omarchy screenrecord --fullscreen

The bar's recording indicator turns on, a file appears in ~/Videos, and /tmp/omarchy-screenrecord.log no longer contains Could not open video codec.

Sources

screenrecord-nvenc-api-13-1-required-pascal-580xx