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
Objective-C++Apache-2.0Created 2017-11-07
Download: Release v1.4.2Release-1.4.2 ↓1.4.22026-07-24
+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

Discussions

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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON