nullmoth /nvidia-macos-driver

Metal driver for NVIDIA GeForce cards on macOS Sequoia

★ 4,422⑂ 430👁 29⑃ 143● 446▤ 80
RustNOASSERTIONCreated 2026-10-07nullmothsystems.com
Download: 1401 and NVIDIA driver 3.01401-3.0 ↓3.02026-11-14
+17
Daily
+175
Weekly
+1,698
Monthly
4,422
stars
430
forks
29
watchers
143
prs
446
issues
80
releases

README

NullMoth NVIDIA Driver for macOS

A Metal driver for NVIDIA GeForce cards on macOS 15 Sequoia (Intel Macs and OpenCore PCs). It is open source; the
kernel extensions, the Metal plugin and the shader translator are in this repository. The 1401 app that installs it
(Mac and Windows) is its own project: 1401.

Supported cards are Turing and newer: GTX 16, RTX 20, 30, 40 and 50, TITAN RTX, Quadro RTX and the T-series. Most
testing is done on an RTX 5060, so other cards may have problems that haven't been found yet. See
card support for what has been reported working.

- Changes: CHANGELOG.md, downloads on the releases page
- Problems: troubleshooting, then Send logs from the 1401 app
- Installing macOS from Windows: 1401
- How it works: docs/HOW-IT-WORKS.md
- Contributing: CONTRIBUTING.md

If your PC doesn't boot macOS with OpenCore yet, set that up first with the
OpenCore Install Guide, then install the driver.

Support the work: https://buymeacoffee.com/nullmoth

| | |
|---|---|
| macOS | 15.5 Sequoia or later (tested 15.7.x and 15.8.1), or 26 Tahoe, x86_64 |
| GPUs | NVIDIA Turing and later; developed on an RTX 5060 |
| Metal | Metal 3: argument buffers tier 2, ray tracing, mesh shaders, MPS, MetalFX path |
| Also | OpenGL (through Apple's GL-on-Metal), OpenCL, Core Image, Core ML |

 How it works


Metal app ─► NVMTLDriver.bundle ─► translator (Apple AIR → SPIR-V) ─► NVK (Mesa Vulkan + NAK compiler) ─► kexts ─► GPU


| Component | Path on disk | Source |
|---|---|---|
| Metal driver plugin | /Library/GPUBundles/NVMTLDriver.bundle | plugin/ |
| Shader translator | inside the plugin (libnvmtl_translate.dylib) | translator/ (LGPL-3.0, based on metal2vulkan) |
| Vulkan back end (NVK) | /Library/GPUBundles/nvmtl/ | nvk/nvk-macos.patch and the chain in build/build_nvk.sh on Mesa 90a959eb (26.3.0-rc3) |
| Kernel extensions | /Library/Extensions/NVRM, NVAccel, NVRMFB, NVRMAGDC | kexts/ |
| GPU firmware (GSP) | /Library/NullMoth/nvfw/nvidia/620.70.06 | NVIDIA, unmodified; fetched from NVIDIA's driver package at install (package/fw_fetch.sh) |

The kernel side runs NVIDIA's own open GPU kernel modules (r610) under macOS. NVRMFB is the display framebuffer,
NVAccel the accelerator WindowServer composites through, NVRMAGDC the display-policy shim.

 Install — by hand

Use the 1401 Mac app below unless you manage your OpenCore config yourself. install.sh installs the driver files but
does not change OpenCore, and the driver does not start until OpenCore has these settings:

- boot-args include nvfb=1 nvaccel=1 nvfbheads=4 -nvkmsnosmooth amfi_get_out_of_my_way=0x1 amfi=0x80
  ipc_control_port_options=0, and not nv_disable=1 or -wegnoegpu (both hide the NVIDIA card)
- csr-active-config includes the bits 0x0A43
- Misc  Security  SecureBootModel is Disabled
- Lilu.kext and AMFIPass.kext are in Kernel  Add and enabled

Download nullmoth-nvidia-.tar.gz from Releases, then:

bash
tar -xzf nullmoth-nvidia-.tar.gz && cd pkgroot
shasum -a 256 -c SHA256SUMS
sudo ./instal

Top issues

Latest release

1401 and NVIDIA driver 3.0 v3.0 2026-11-14
Fixes
- Processes that lost the GPU right after login on 2.9 (transparent Dock, icons that went missing, a lock screen that crashed in a loop, apps that crashed at launch): the GPU could read a small command before the driver's write of it was visible to it and stopped the process's channel. The memory those commands are written to is no longer cached by the GPU.
- System Settings  Displays hanging for seconds when it opens (567): a search of the shader text ran on every call; its answer is kept.
- Apps built with an old SDK that crashed at launch on the NVIDIA device (Canon CaptureOnTouch 571

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON