From 1541758ea4493de73e09cf94f0b1e7a35e52565c Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 2 Feb 2026 23:53:41 +0000 Subject: [PATCH] Update macOS install docs to reflect current build offerings - Remove non-Metal build links (no longer recommended by retroarch.com) - Simplify download links to just Stable and Nightly - Explain "Metal" build name is historical and includes multiple video drivers - Add warning that metal video driver is experimental and unsupported https://claude.ai/code/session_01Fq8E1iK3pMoq8xUQ7ShtTF --- docs/guides/install-macos.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/guides/install-macos.md b/docs/guides/install-macos.md index 773c65dc02..f38238be4a 100644 --- a/docs/guides/install-macos.md +++ b/docs/guides/install-macos.md @@ -6,18 +6,19 @@ Download one of the .dmg files from here: -* [Stable Metal](https://buildbot.libretro.com/stable/{{ unit.stable }}/apple/osx/universal/RetroArch_Metal.dmg) -* [Nightly Metal](https://buildbot.libretro.com/nightly/apple/osx/universal/RetroArch_Metal.dmg) -* [Stable non-Metal](https://buildbot.libretro.com/stable/{{ unit.stable }}/apple/osx/x86_64/RetroArch.dmg) -* [Nightly non-Metal](https://buildbot.libretro.com/nightly/apple/osx/x86_64/RetroArch.dmg) +* [Stable](https://buildbot.libretro.com/stable/{{ unit.stable }}/apple/osx/universal/RetroArch_Metal.dmg) +* [Nightly](https://buildbot.libretro.com/nightly/apple/osx/universal/RetroArch_Metal.dmg) The install follows the standard process of opening the .dmg file and copying RetroArch.app into the Applications folder. -### Metal vs non-Metal builds +### About the "Metal" build name -Most people should start with the Metal build. The Metal has more features, and is a Universal binary. The non-Metal build is x86_64-only and only includes the OpenGL graphics driver. However, the Metal build only supports macOS 10.13+, whereas the non-Metal build supports 10.9+. +The downloadable builds are named "Metal" for historical reasons. This build is a Universal binary (supporting both Intel and Apple Silicon Macs) and includes multiple video drivers: Vulkan, glcore (OpenGL 3/4), and an experimental Metal driver. Most users should use the Vulkan or glcore video drivers. -It is possible to build RetroArch for older versions of macOS, though due to resource constraints these are not provided. See the [instructions for building on macOS](../development/retroarch/compilation/osx.md) to build it yourself. +!!! warning "Metal video driver is experimental" + The metal video driver within RetroArch is experimental, largely untested, and not well supported. If you encounter issues, switch to the Vulkan or glcore video driver instead. + +The Metal build requires macOS 10.13 or later. It is possible to build RetroArch for older versions of macOS, though due to resource constraints these are not provided. See the [instructions for building on macOS](../development/retroarch/compilation/osx.md) to build it yourself. ### Stable vs nightly builds