NVIDIA Graphics Acceleration on macOS - NullMoth NVIDIA Driver | GeForce GTX 16, RTX 20/30/40/50

[MaLd0n]

Hello everyone!

I'd like to share an interesting project with the Hackintosh community: NullMoth NVIDIA Driver for macOS, a source-available graphics driver developed by NullMoth Systems that aims to bring NVIDIA GPU acceleration back to modern macOS systems.

For years, NVIDIA graphics support has been one of the biggest limitations for Hackintosh users, particularly since Apple discontinued support for NVIDIA Web Drivers in newer macOS releases.

NullMoth takes a different approach by implementing a graphics driver stack that connects Apple's Metal framework to NVIDIA hardware through a combination of shader translation, Mesa's NVK Vulkan driver, and NVIDIA's open GPU kernel modules.

The project is currently focused on macOS Sequoia running on Intel-based Macs and OpenCore systems, with support targeted at NVIDIA Turing and newer GPU architectures.

Important: This is a new and experimental project. Broad GPU compatibility has not yet been physically validated, and functionality may vary considerably between systems.

Supported NVIDIA GPUs

The driver's device table covers several NVIDIA GPU generations:

Architecture	GPU Families
Turing	GeForce GTX 16, RTX 20, TITAN RTX
Ampere	GeForce RTX 30
Ada Lovelace	GeForce RTX 40
Blackwell	GeForce RTX 50
Workstation	Selected Quadro, RTX A and RTX PRO GPUs

Support for a GPU's PCI device ID does not necessarily mean that the card has been successfully tested on macOS.

According to the project's documentation, physical testing has primarily focused on the GeForce RTX 5060, with additional working reports for RTX 5070 and RTX 5080 configurations.

Other GPUs are included through NVIDIA's supported hardware tables but still require further testing.

Older architectures such as Pascal, Maxwell and Kepler are outside the scope of the current implementation.

Graphics Features

The project implements a number of graphics technologies and interfaces, including:

• Metal graphics acceleration

• Metal 3 interfaces

• OpenGL through Apple's GL-on-Metal implementation

• OpenCL compute support

• Core Image integration

• Metal Performance Shaders (MPS)

• Core ML integration

• Vulkan-based graphics execution through Mesa NVK

• GPU-accelerated desktop composition

• NVIDIA framebuffer and display management

• Support for multiple display outputs

• Hardware H.264 decoding on supported GPUs

• Shader compilation through the NAK compiler

• Implementation paths for ray tracing, mesh shaders and MetalFX

Feature availability depends on the GPU, macOS configuration and driver implementation.

Not all features or applications have been independently validated across every supported GPU generation.

How Does It Work?

Unlike traditional NVIDIA Web Drivers, NullMoth uses a different graphics architecture.

The driver connects Apple's Metal interface to NVIDIA hardware using several components.

1. Metal Driver Plugin

The NVMTLDriver.bundle component implements Metal interfaces used by applications and the macOS graphics system.

2. Shader Translation

A shader translation layer converts Apple's AIR intermediate representation into SPIR-V, allowing shaders to be processed through the Vulkan graphics pipeline.

3. Mesa NVK

The project uses Mesa's open-source NVK Vulkan driver and NAK shader compiler to generate NVIDIA GPU instructions and execute graphics workloads.

4. NVIDIA Open GPU Kernel Modules

The kernel-side implementation adapts NVIDIA's open GPU kernel modules to the macOS XNU environment.

5. Framebuffer and Acceleration Components

Additional kernel extensions provide framebuffer functionality, graphics acceleration integration and display policy handling.

The resulting architecture can be summarized as:

Metal Application → Metal Driver Plugin → Shader Translation → Mesa NVK → NVIDIA Kernel Driver → GPU

This approach is particularly interesting because it does not depend on the traditional proprietary NVIDIA Web Driver architecture previously used on older macOS releases.

macOS Compatibility

The current driver targets:

macOS Sequoia (Intel / x86_64)

OpenCore is required for the supported configurations.

The project is not an official NVIDIA or Apple graphics driver.

Compatibility with other macOS releases should not be assumed unless explicitly documented by the developers.

Apple Silicon Macs are not part of the current supported platform.

Installation and Requirements

The project provides prebuilt driver packages and a companion installation application.

For an existing Hackintosh installation, the basic requirements include:

• A compatible NVIDIA GPU

• macOS Sequoia

• A working OpenCore configuration

• Appropriate BIOS/UEFI graphics settings

• The required macOS security and kernel-extension configuration

• The NullMoth NVIDIA driver package

The installation process involves configuring OpenCore, installing the driver components and rebuilding the required macOS kernel collection.

The project also provides the 1401 Mac application, designed to simplify installation, configuration, logging and removal of the driver.

For users installing macOS from Windows, the separate 1401 project provides tools for preparing the installation media and OpenCore environment.

Please note: Installation requires changes to security-related settings, including SIP and Secure Boot configuration. These changes have security implications and should only be made after reviewing the official documentation.

The developers recommend following the instructions provided in the repository rather than assuming that settings from older NVIDIA Hackintosh configurations will work.

Current Limitations

Despite the progress described by the project, there are still important limitations.

The developers document ongoing issues involving:

• Screen flickering on certain high-refresh-rate configurations

• Flickering with some multi-monitor setups

• HDMI and DisplayPort audio output from the NVIDIA GPU

• Hardware compatibility differences between desktop and laptop systems

• Limited physical validation across the advertised GPU families

Laptop configurations may also require a direct display connection to the NVIDIA GPU. The driver does not automatically provide support for NVIDIA Optimus switching or unsupported display routing.

This remains experimental software and should not yet be considered a drop-in replacement for a fully mature graphics driver.

Download and Source Code

Official Project Repository

https://github.com/nullmoth/nvidia-macos-driver

Driver Downloads and Releases

https://github.com/nullmoth/nvidia-macos-driver/releases

1401 – macOS Installation and Configuration Tools

https://github.com/nullmoth/1401

Technical Documentation

https://github.com/nullmoth/nvidia-macos-driver/blob/main/docs/HOW-IT-WORKS.md

GPU Compatibility Information

https://github.com/nullmoth/nvidia-macos-driver/blob/main/docs/CARD-SUPPORT.md

Official Website

https://nullmothsystems.com

The repository includes driver components, installation tools, source code, build instructions and technical documentation.

Credits & Acknowledgments

This project builds upon multiple graphics technologies and open-source components developed by the broader software and GPU development community.

Full credit belongs to their respective developers and maintainers.

NullMoth Systems

• Development and maintenance of the NullMoth NVIDIA Driver for macOS.

• Metal driver implementation, integration, macOS compatibility layers and installation utilities.

Anees Iqbal (steelbrain)

• Original developer of metal2vulkan, the project upon which NullMoth's shader translation component is based.

• https://github.com/steelbrain/metal2vulkan

Mesa Developers and Contributors

• Development of the Mesa graphics stack, including the NVK Vulkan driver and NAK shader compiler.

• https://mesa3d.org

NVIDIA Corporation

• NVIDIA Open GPU Kernel Modules and GPU System Processor firmware used by the project.

• https://github.com/NVIDIA/open-gpu-kernel-modules

Acidanthera and OpenCore Contributors

• Development of OpenCore and related technologies used by the Hackintosh community.

• https://github.com/acidanthera/OpenCorePkg

Dortania and the Hackintosh Community

• OpenCore documentation, installation resources, research and ongoing contributions to macOS compatibility.

• https://dortania.github.io/OpenCore-Install-Guide/

Special thanks to everyone involved in Mesa, NVIDIA open driver development, reverse engineering, testing and documenting graphics technologies.

Licensing

The project is available free of charge with source code, but it is not licensed for unrestricted commercial use.

The main NullMoth components are distributed under the PolyForm Noncommercial License.

Third-party components retain their respective licenses, including LGPL for the shader translator, MIT for Mesa-related changes and NVIDIA's applicable licenses for kernel modules and firmware.

Please review the repository's LICENSE and NOTICE files before redistributing or modifying the software.

Final Thoughts

The NullMoth NVIDIA Driver is an ambitious effort to address one of the most significant limitations of modern Hackintosh systems: NVIDIA graphics acceleration.

Its architecture, combining Metal compatibility layers, Mesa NVK, shader translation and NVIDIA's open kernel modules, represents an interesting alternative to the legacy NVIDIA Web Driver approach.

Although the project is still experimental and requires considerably more hardware testing, it may open new possibilities for users with NVIDIA Turing, Ampere, Ada Lovelace and Blackwell GPUs.

Community testing and feedback are welcome!

If you're testing the driver, consider sharing:

• NVIDIA GPU model and PCI Device ID

• CPU and motherboard

• macOS build

• OpenCore configuration

• Display connections and refresh rates

• Working features and known problems

• Relevant logs or crash reports

Sharing detailed results can help the developers identify compatibility problems and improve the project.

As always, back up your OpenCore EFI and macOS installation before making driver or system modifications.

Official GitHub: https://github.com/nullmoth/nvidia-macos-driver

Thanks to NullMoth Systems and all the developers contributing to graphics driver development and the Hackintosh community!