Accelerated Video Playback

This page is meant to help with techniques for getting accelerated video playback working in NixOS. This is generally done via libva and vaapi (and sometimes vdpau).

This is done by adding relevant libva-related packages to the hardware.opengl.extraPackages option.

Additionally, the vaapiIntel package can be overriden to enable Intel's Hybrid Driver.

Intel users also can enable intel-media-driver. It can be used at runtime with LIBVA_DRIVER_NAME=iHD mpv ... for example, if you use Mic92's mpv settings below.

Sample configuration:

{
  ...
  nixpkgs.config.packageOverrides = pkgs: {
    vaapiIntel = pkgs.vaapiIntel.override { enableHybridCodec = true; };
  };
  hardware.opengl = {
    enable = true;
    extraPackages = with pkgs; [
      intel-media-driver # LIBVA_DRIVER_NAME=iHD
      vaapiIntel         # LIBVA_DRIVER_NAME=i965 (older but works better for Firefox/Chromium)
      vaapiVdpau
      libvdpau-va-gl
    ];
  };
  ...
}

32 bit example:

hardware.opengl.extraPackages32 = with pkgs.pkgsi686Linux; [ vaapiIntel ];

Prepared Hardware configuration

Sometimes different opengl packages are required to achieve full performance. You can check different configuration repositories for similar hardware configuration:

The NixOS-Hardware Repository

Testing your configuration

You can test your configuration by running: nix-shell -p libva-utils --run vainfo

See Hardware video acceleration: Verification (Arch Wiki) for more information.

Applications

Chromium

See Chromium.

Firefox

See Firefox#Hardware_video_acceleration (ArchWiki).

Mesa requires the kcmp system call to be available. If this is not there, video acceleration will not work (for at least amdgpu users). You can modify the kernel config like this to provide the system call.

  boot.kernelPatches = [ {
    name = "amdgpu-mesa-fix";
    patch = null;
    # https://wiki.archlinux.org/index.php/Firefox#Hardware_video_acceleration
    extraConfig = ''
      CHECKPOINT_RESTORE y
    '';
   } ];

MPV

You can place the following configuration in ~/.config/mpv/mpv.conf for mpv to use hardware acceleration for VP9 on Intel Broadwell (and probably later):

hwdec=auto-safe
vo=gpu
profile=gpu-hq

With Wayland, you need to nudge mpv to do the right thing:

gpu-context=wayland

This is based on the archlinux MPV article.

Other

See the Arch Linux wiki.