Files
OpenCore-Legacy-Patcher/docs/TROUBLESHOOT-NONMETAL.md
neon ball 2d6d1f0235 Overhaul Troubleshooting categorization
Separate hardware issues to own section as well and rename sites with better consistency.
2025-08-07 23:01:10 +03:00

5.3 KiB

Non-Metal issues

The below page is for users experiencing issues with their overall usage of macOS Big Sur and newer and the Legacy Graphics Acceleration patches. Note that the following GPUs currently do not have acceleration support in Big Sur and newer:

  • Intel 3rd and 4th Gen - GMA series

For those unfamiliar with what is considered a non-Metal GPU, see the chart below:

::: details macOS GPU Chart

Metal is Apple's in-house graphics API that acts as a replacement for OpenGL/OpenCL, introduced in 2015. With the release of macOS Mojave, every system without a Metal-capable GPU was dropped.

Graphics Vendor Architecture Series Supports Metal
ATI TeraScale 1 HD 2XXX - HD 4XXX No
^^ TeraScale 2 HD 5XXX - HD 6XXX ^^
AMD GCN (and newer) HD 7XXX+ Yes
NVIDIA Tesla 8XXX - 3XX No
^^ Fermi 4XX - 5XX ^^
^^ Kepler 6XX - 7XX Yes
^^ Maxwell 8XX - 9XX No (on 10.14 and newer)
^^ Pascal 10XX ^^
Intel GMA GMA 900 - GMA X3000 No
^^ Iron Lake HD series ^^
^^ Sandy Bridge HD 3000 ^^
^^ Ivy Bridge (and newer) HD 4000 Yes

:::

Broken Background Blurs

By default with the non-Metal acceleration patches, many background blur menus may act distorted when moving a cursor over it. With 0.4.1 and newer, users can enable a new Beta Blur feature to try and resolve the issue:

Beta Blur settings

Do note that enabling beta blurs can be more demanding on slower hardware

Downloading older non-Metal Apps

Many Apple apps now have direct reliance on Metal for proper functioning, however legacy builds of these apps still do work in Big Sur. See below for archive of many apps such as Pages, iMovie, GarageBand.

Note: This archive assumes that you own these copies of these apps through the Mac App Store, Dortania does not condone piracy

Unable to run Zoom

Currently Zoom relies partially on Metal and so needs a small binary patch. Dosdude1 has provided a nice script for this:

Unable to grant special permissions to apps (ie. Camera Access to Zoom)

Currently for Ventura 13.3 and newer, due to new patches required, permissions are yet again broken. Use TCCPlus in the Workaround dropdown to work around the issue.

This issue is fully resolved for 13.2.1 and lower starting from 0.2.5.

::: details Workaround for 0.2.4, Ventura 13.3+

Due to the usage of amfi_get_out_of_my_way=1, macOS will fail to prompt users for special permissions upon application start as well as omit the entries in System Preferences. To work around this, we recommend users install tccplus to manage permissions.

Download TCCPlus

Example usage with Discord and microphone permissions:

# Open Terminal and run the following commands
cd ~/Downloads/
chmod +x tccplus
./tccplus add Microphone com.hnc.Discord

For those who may experience issues with tccplus, you can manually patch com.apple.TCC to add permissions:

# get app id (Zoom.us used in example):
$ osascript -e 'id of app "zoom.us"'
# output: us.zoom.xos

$ sudo sqlite3 ~/Library/Application\ Support/com.apple.TCC/TCC.db "INSERT or REPLACE INTO access VALUES('kTCCServiceMicrophone','us.zoom.xos',0,2,0,1,NULL,NULL,NULL,'UNUSED',NULL,0,1541440109);"

$ sudo sqlite3 ~/Library/Application\ Support/com.apple.TCC/TCC.db "INSERT or REPLACE INTO access VALUES('kTCCServiceCamera','us.zoom.xos',0,2,0,1,NULL,NULL,NULL,'UNUSED',NULL,0,1541440109);"

:::

Photos and Maps app issues

Starting from macOS Monterey, Maps and everything relying on it (such as Find My or 'Places' in Photos) are non-functional on non-Metal due to Metal reliance.

Cannot press "Done" when editing a Sidebar Widget

Workaround: Press some combination of Tab, or Tab and then Shift-Tab, or just Shift-Tab until the "Done" button is highlighted. Then press spacebar to activate the button, the same as in any other dialog with a highlighted button halo.

Unable to allow Safari Extensions

Due to a bug in the legacy acceleration patches, users won't be able to enable Safari Extensions.

The following tool can be used to work-around this issue: