nvidia-vaapi-driver
This is an VA-API implementation that uses NVDEC as a backend. This implementation is specifically designed to be used by Firefox for accelerated decode of web content, and may not operate correctly in other applications.
It's currently in early development, so don't expect it to work well.
This library requires that the nvidia_drm
kernel module is configured with the parameter nvidia-drm.modeset=1
Codec Support
Only decoding video is currently supported.
Codec | Supported | Comments |
---|---|---|
H.264 | ||
HEVC | ||
VP8 | ||
VP9 | ||
AV1 | Not completed, my 1060 doesn't support decoding it | |
MPEG-2 | ||
MPEG-4 | Not sure if this can be made work. NVDEC seems to require more information than VA-API supplies | |
VC-1 | ||
JPEG | This is unlikely to ever work, the two APIs are too different |
Currently, 10-bit videos are not supported due to the NVIDIA driver not allowing R16 and RG1616 surfaces to be imported.
Building
You'll need the gstreamer-plugins-bad library installed.
Then run the following commands:
meson setup build
meson install -C build
Debugging
The NVD_LOG
environment variable can be used to control logging, NVD_LOG=1
will log to stdout, and NVD_LOG=<filename>
will append to the specified file (or stdout if the file can't be opened).
Firefox
To use the driver with firefox you will need at least Firefox 96 (currently in beta), the following config options need to be set in the about:config page:
Option | Value | Reason |
---|---|---|
media.ffmpeg.vaapi.enabled | true | Required, enables the use of VA-API |
security.sandbox.content.level | 0 | Required on Firefox 96, disables the sandboxing for the content process. Note This is not recommended for general use as it reduces security |
security.sandbox.content.syscall_whitelist | 41,49,50,332 | Required on Firefox 97+, allows certain syscalls through the sandbox. In order those are: socket, bind, listen, statx. Note This is not recommended for general use as it reduces security |
media.ffvpx.enabled | false | Required, disables the internal software decoders for VP8/VP9 |
media.rdd-vpx.enabled | false | Required, disables the remote data decoder process for VP8/VP9 |
media.navigator.mediadatadecoder_vpx_enabled | true | Optional, enables hardware VA-API decoding for WebRTC. |
media.av1.enabled | false | Optional, disables AV1. The driver doesn't support AV1 playback yet. This will prevent sites attempting to use it and falling back to software decoding |
gfx.x11-egl.force-enabled | true | This driver requires that Firefox use the EGL backend. If it isn't selecting it by default, it'll need to be forced on using this option or by setting the MOZ_X11_EGL environment variable to 1 . It's recommended you try the environment variable method first to test it. |
In addition the LIBVA_DRIVER_NAME
environment variable needs to be set to nvidia
.
Firefox 97 currently requires setting the MOZ_DISABLE_RDD_SANDBOX
environment variable to 1
, as a change has force VA-API into the RDD process, not the content process which bypasses all the whitelisting.
MPV
There's no real reason to run it with mpv except for testing, as mpv already supports using nvdec directly. The test.sh
script will run mpv with the file provided and various environment variables set to use the newly built driver