nullmoth/nvidia-macos-driver

选用指南

AI 根据 README 整理 · 2026/10/10 22:50:55

适用场景

适用于在macOS 15 Sequoia上使用NVIDIA Turing及更新显卡的Intel Mac或OpenCore系统，特别是RTX 5060等已测试显卡。

查看 README 依据

# NullMoth NVIDIA Driver for macOS A Metal driver for NVIDIA Turing-and-later cards on Intel Macs and OpenCore systems running **macOS 15 Sequoia**. The device table includes GTX 16, RTX 20/30/40/50, TITAN RTX, and supported Quadro/RTX workstation cards. The driver implements NVIDIA-backed display and Metal interfaces. Feature availability and application behavior depend on the card, operating-system version and installed components; device-table coverage is not runtime qualification. Made by **NullMoth Systems**.

> [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/) > ([OpenCore releases](https://github.com/acidanthera/OpenCorePkg/releases)), then install the driver. > The full write-up of how the driver works is in [`docs/HOW-IT-WORKS.md`](docs/HOW-IT-WORKS.md). Support the work: https://buymeacoffee.com/nullmoth | | | |---|---| | macOS | 15 Sequoia (tested 15.7.x and 15.8.1), x86_64 | | GPUs | NVIDIA Turing and later from the GSP device table; physical validation: RTX 5060 | | Metal | Metal 3: argument buffers tier 2, ray tracing, mesh shaders, MPS, MetalFX path |

目标用户

面向需要在macOS上使用NVIDIA显卡的用户，包括OpenCore系统使用者。

查看 README 依据

# NullMoth NVIDIA Driver for macOS A Metal driver for NVIDIA Turing-and-later cards on Intel Macs and OpenCore systems running **macOS 15 Sequoia**. The device table includes GTX 16, RTX 20/30/40/50, TITAN RTX, and supported Quadro/RTX workstation cards. The driver implements NVIDIA-backed display and Metal interfaces. Feature availability and application behavior depend on the card, operating-system version and installed components; device-table coverage is not runtime qualification. Made by **NullMoth Systems**.

使用方式

可通过预构建包安装，或使用1401 Mac应用简化安装，也可从源码构建。

查看 README 依据

| Kernel extensions | `/Library/Extensions/NVRM, NVAccel, NVRMFB, NVRMAGDC` | `kexts/` | | GPU firmware (GSP) | `/Users/Shared/nvfw/nvidia/610.57.04` | NVIDIA, unmodified | 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 — prebuilt (recommended) Download `nullmoth-nvidia-<version>.tar.gz` from **Releases**, then: ```bash tar -xzf nullmoth-nvidia-*.tar.gz && cd pkgroot

shasum -a 256 -c SHA256SUMS # every file must say OK sudo ./install.sh # copies the files, rebuilds the Auxiliary Kernel Collection sudo shutdown -r now # a reboot is required: logout does not load the driver ``` macOS asks you to **allow the extensions** in System Settings → Privacy & Security the first time. Allow, then reboot again. ## 1401 Mac app (easiest) Download the latest `1401-Mac-<version>.dmg` from **Releases**, open it, and run **1401** (the driver package is inside the disk

sudo ./uninstall.sh && sudo shutdown -r now ``` ## Build from source Requires Xcode 16, Rust (stable), Meson/Ninja, and NVIDIA's `open-gpu-kernel-modules` at tag `610.57.04`. ```bash build/build_xlate.sh # translator -> libnvmtl_translate.dylib RELEASE=1 build/build_plugin.sh # plugin -> NVMTLDriver.bundle (RELEASE=1 strips every diagnostic) build/build263.sh # NVK: apply nvk/nvk-macos.patch to Mesa 17ca6174 first build/accel_build.sh <src> <out> # kexts ``` ## License Free of charge, source code included. Nobody may sell it or use it to make money.

部署要求

需要macOS 15 Sequoia（x86_64），支持NVIDIA Turing及更新显卡，需OpenCore引导，并设置特定NVRAM和BIOS选项。

查看 README 依据

> [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/) > ([OpenCore releases](https://github.com/acidanthera/OpenCorePkg/releases)), then install the driver. > The full write-up of how the driver works is in [`docs/HOW-IT-WORKS.md`](docs/HOW-IT-WORKS.md). Support the work: https://buymeacoffee.com/nullmoth | | | |---|---| | macOS | 15 Sequoia (tested 15.7.x and 15.8.1), x86_64 | | GPUs | NVIDIA Turing and later from the GSP device table; physical validation: RTX 5060 | | Metal | Metal 3: argument buffers tier 2, ray tracing, mesh shaders, MPS, MetalFX path |

The kexts install into `/Library/Extensions` and load from the Auxiliary Kernel Collection — **do not** also inject them from `EFI/OC/Kexts`. OpenCore only needs to set SIP and boot-args. **`NVRAM → Add → 7C436110-AB2A-4BBB-A880-FE41995C9F82`** | Key | Value | Why | |---|---|---| | `csr-active-config` | `<430A0000>` (Data) | the tested value: unsigned kexts, plus what root patches need | | `boot-args` | `nvfb=1 nvaccel=1 nvfbheads=4 -nvkmsnosmooth amfi_get_out_of_my_way=0x1 amfi=0x80` | framebuffer + accelerator, 4 display heads; the AMFI args let WindowServer load the driver bundle |

The macOS **installer** needs the opposite BAR settings (`ResizeAppleGpuBars` `0`, `ResizeGpuBars` `-1`, IONDRVSupport not excluded): it has no NVIDIA driver and runs on the firmware's screen. 1401 builds installers that way, and the 1401 Mac app switches to the values above when it installs the driver. Also required: - **BIOS:** Above 4G Decoding ON (the card maps memory above 4 GB), CSM OFF. - **SMBIOS:** a Mac model that runs macOS 15 with a discrete GPU (tested: `iMacPro1,1`, which 1401 uses).

已知限制

驱动较新，可能不适用于所有PC，仅测试了RTX 5060，设备表覆盖范围大于实际验证。

查看 README 依据

**Latest update:** [1401 and NVIDIA driver 1.1.0](docs/RELEASE-1.1.0.md). See the changes, validation and qualification scope before updating. Installing macOS from Windows? Use **1401**: https://github.com/nullmoth/1401 > **This driver is new and may not work on every PC.** It is tested on an RTX 5060 under macOS 15.7.x and 15.8.1. Device-table coverage is broader than physical hardware validation; see [card support](docs/CARD-SUPPORT.md). If your PC does > not boot macOS with OpenCore yet, set that up first with the