Almosst-DEV / Cobalt64

Cobalt64 
 The first open-source GPU-accelerated graphics driver for macOS. 
 Native Metal acceleration for modern AMD Radeon GPUs that Apple does not support.
 Visit cobalt64.com to check whether your graphics card is supported,
 read how Cobalt64 works and get the first public release when it ships.
---
## About
Apple's own AMD drivers end with RDNA 2. Cobalt64 is an open-source graphics driver that
brings modern Radeon GPUs to macOS: it brings up the GPU itself, runs Metal on top of a
macOS port of Mesa's RADV Vulkan driver, and drives the displays natively.
The first supported family is **RDNA 4**, starting with the **Radeon RX 9070 XT (Navi 48)**,
where all development and testing happens today. Other families (for example RDNA 3 /
RX 7000) are future work: much of the stack is shared, but each GPU generation needs its own
display and power-management bring-up, and someone with that hardware to test it.
## Status
Reached on one x86_64 test PC with an RX 9070 XT, macOS Tahoe 26.6.2, booted through OpenCore:
- **GPU-composited desktop on three displays at once** (one DisplayPort, two HDMI), with
 WindowServer's Metal compositor running on this driver stack.
- **Apps on the GPU:** a growing set of built-in apps (Maps, Preview, Photos, System Settings,
 Music and others) render through it.
- **Resizable BAR**, and the driver arming itself at boot.
This is a **preview**: a lot is still rough, display modes are limited to what the test PC's
monitors needed, and many pieces work around one specific macOS build.
### In progress
- 4K output over HDMI
- Smoother frame pacing and higher refresh rates
- GPU rendering for more apps (Safari, Chromium/Electron apps)
- Display modes from each monitor's EDID instead of fixed modes
- Hardware video decoding
## Can I install this?
**Not yet.** Wait for the first public release; it will come with an installer and a
step-by-step guide on cobalt64.com. This repository is the source
code, and running it today needs a lot of manual setup on a separate macOS install.
## What this repo contains
| Path | Contents |
|---|---|
| `src/navi48-bringup` | Bring-up kext (IOKit): PCIe/BAR setup, IP discovery, PSP/SMU/GMC/GFX/SDMA/MES initialisation, display (DCN 4.1) mode-setting, a user client ("N48N") exposing buffers, command submission and scanout, and hooks into Apple's AMDRadeonX6000 accelerator. |
| `src/dcn41` | DCN 4.1 display-engine helpers and generated register headers (derived from Linux amdgpu, MIT). |
| `src/xlat12` | Command-stream translation from Apple's GFX10.3 PM4/register programming to gfx12. |
| `src/g2capture` | Small capture tool for Apple shader-compiler records. |
| `tools/native` | navi48metal (a Metal device bundle that runs Metal on top of the Vulkan driver), mtlprobe (API probe), autotranslate (AIR -> SPIR-V translation scripts) and navi48accel (aux kext). |
| `tools/pc`, `tools/dcn41`, `tools/conductor` | PC-side test CLI and run scripts, display-register tooling, test suite runners and "plante