KhronosGroup /MoltenVK
MoltenVK is a Vulkan Portability implementation. It layers a subset of the high-performance, industry-standard Vulkan graphics and compute API over Apple's Metal graphics framework, enabling Vulkan applications to run on macOS, iOS and tvOS.
★ 5,933⑂ 609👁 128⑃ 1,533● 1,256▤ 80
+5
Daily
5,933
stars
609
forks
128
watchers
1,533
prs
1,256
issues
80
releases
README
[!CAUTION] Deprecation notice: Khronos has deprecated MoltenVK, its Vulkan-on-Metal implementation. This repository is now maintained by the community on a best-effort basis. For Vulkan on Metal, Khronos now recommends KosmicKrisp on Apple Silicon Macs. MoltenVK remains the recommended option for Intel-based Macs and for iOS. You can get KosmicKrisp in either of two ways: - Install the latest macOS Vulkan SDK from vulkan.lunarg.com. - Build the KosmicKrisp driver from the Mesa project source. MoltenVK ======== Copyright (c) 2015-2026 The Brenwill Workshop Ltd. [comment]: "This document is written in Markdown (http://en.wikipedia.org/wiki/Markdown) format." [comment]: "For best results, use a Markdown reader." !Build Status Table of Contents ----------------- - Introduction to MoltenVK - Developing Vulkan Applications on macOS, iOS, tvOS, and visionOS - Using the Vulkan SDK - Using MoltenVK Directly - Fetching MoltenVK Source Code - Building MoltenVK - Building With _Xcode_ - Building From the Command Line - Hiding _Vulkan_ API Symbols - Accessing _Metal_ Private API Calls - Install MoltenVK to Replace The _Vulkan SDK_ libMoltenVK.dylib - Running MoltenVK Demo Applications - Using MoltenVK in Your Application - MoltenVK and Vulkan Compliance - Getting Support - Contributing to MoltenVK Development Introduction to MoltenVK ------------------------ MoltenVK is a layered implementation of Vulkan 1.4 graphics and compute functionality, that is built on Apple's Metal graphics and compute framework on macOS, iOS, tvOS, and visionOS. MoltenVK allows you to use Vulkan graphics and compute functionality to develop modern, cross-platform, high-performance graphical games and applications, and to run them across many platforms, including macOS, iOS, tvOS, visionOS, Simulators, and Mac Catalyst, and all Apple architectures, including Apple Silicon. Metal uses a different shading language, the Metal Shading Language (MSL), than Vulkan, which uses SPIR-V. MoltenVK automatically converts your SPIR-V shaders to their MSL equivalents. To provide Vulkan capability to the macOS, iOS, tvOS, and visionOS platforms, MoltenVK uses Apple's publicly available API's, including Metal. MoltenVK does _not_ use any private or undocumented API calls or features, so your app will be compatible with all standard distribution channels, including Apple's App Store. The MoltenVK runtime package contains two products: - MoltenVK is a implementation of an almost-complete subset of the Vulkan 1.4 graphics and compute API. - MoltenVKShaderConverter converts SPIR-V shader code to Metal Shading Language (MSL) shader code. The converter is embedded in the MoltenVK runtime to automatically convert SPIR-V shaders to their MSL equivalents. In addition, the SPIR-V converter is packaged into a stand-alone command-line MoltenVKShaderConverter macOS tool for converting shaders at development time from the command line. Developing Vulkan Applications fo
Top issues
#203Requirements for DXVK support..174 comments · 2018-07-27#2054Detroit: Become Human crashes under Wine153 comments · 2023-11-01#427Raytracing support53 comments · 2018-12-26#1542Flickering in highly lit areas on Mac in FFXIV41 comments · 2022-03-09#1524Add support for geometry shaders41 comments · 2022-02-11#214VKD3D Vulkan requirements..36 comments · 2018-08-04#1650FFXIV fails to run on Mac with > 100GB RAM26 comments · 2022-07-16#1507Dark Souls 3: Unstable frame rate on macOS24 comments · 2022-01-17
Discussions
#2751can one Compile debug-mode libMoltenVK.dylib by OCLP intel-mac/Ventura; for sole purpose of Running on true-blue intel-mac Monterey1 comments · 2026-06-06#2716MoltenVK Limitations on iOS Simulator0 comments · 2026-04-16#2709Congrats for the latest Minecraft snapshot release0 comments · 2026-04-07#2688Investigating performance of MSAA1 comments · 2026-02-05#2633How do I build MoltenVK with private api enabled?1 comments · 2025-10-08#2555Does MoltenVK allow vertexAttributeAccessBeyondStride if the stride is zero?1 comments · 2025-06-02#2552Specialization constants and local group sizes0 comments · 2025-05-29#2540When do you expect the official VulkanSDK to take MVK 1.3+ ?1 comments · 2025-05-13
Latest release
Release v1.4.2 v1.4.2 2026-07-24- Add support for the following extensions: - VK_EXT_sampler_filter_minmax on Apple10 GPUs with macOS 26 or iOS 26 - Add gl_DrawID / DrawIndex support for MacOS. - Add native sampler min/max filtering. - Fix buffer and heap out-of-sync in initExternalMemory(). - Fix incorrect varable usage in MVKImagePlane::getMTLTexture(). - Fix incorrect placement heap check in MVKImagePlane::getMTLTexture(). - Fix device loss when using imported MTLTexture objects with Metal argument buffers. - Raise minimum target to _macOS 12.0 / iOS 15.0 / tvOS 15.0_ - Fix desync in primitive restart enable st