Repository navigation
MetalSharp Wine 5.0
MetalSharp Wine 5.0 is Wine 11.20 for Apple silicon, native arm64 with x86 code run by FEX. It brings MetalFX upscaling to every graphics lane and DLSS on MetalFX: Super Resolution, Ray Reconstruction and Frame Generation, in games that ship them. It updates every graphics lane: Mullion with its Direct3D 12 work, VKD3D-Proton-MacOS 5.0, DXVK-MacOS with MetalFX, and WineMetalGL 3.8.0. It also fixes displays, fullscreen, the mouse, window painting and wined3d on Vulkan, and how FEX handles games that patch their own code.
Upscaling and DLSS
- MetalFX on every lane. MetalSharp's MetalFX setting applies to Mullion, VKD3D-Proton, DXVK-MacOS and WineMetalGL (OpenGL).
- The game is shown the main display divided by the upscale factor (Wine 0103, 0114), and MetalFX scales its frames back up to the display.
- A MetalFX game stays out of native macOS fullscreen (0113), and its smaller swap chain isn't reported as suboptimal, which had made some games recreate it every frame (0110).
- Its Vulkan surface is scaled like its window. Before, ELDEN RING on VKD3D-Proton was drawn in a corner of the screen (0124).
- DLSS on MetalFX, in games that ship it:
- Super Resolution runs on MetalFX's temporal scaler, Ray Reconstruction on its denoising scaler (macOS 26 or later), and Frame Generation on its frame interpolator (macOS 27).
- It works on Mullion and VKD3D-Proton, for games that call NGX directly and for games that go through Streamline (The Witcher 3, God of War Ragnarök). DXVK-MacOS has DLSS Super Resolution and MetalFX for Direct3D 11 games (0112).
- Every game that comes with DLSS is set up for it (0106). Each lane loads its own NGX core and NVAPI (0108, 0109), and
winemac.confnames the GPU a game sees in Windows' device list (0104). - Windows reports hardware-accelerated GPU scheduling, which Frame Generation requires (0121). Vulkan initialization survives Streamline's Frame Generation check, which enumerates Vulkan GPUs from inside it (0123).
- The Witcher 3 and God of War Ragnarök have
HideWineExportson by default, since they turn DLSS off when they find Wine (0105).
Direct3D 10, 11 and 12: Mullion
Mullion (the default Direct3D lane) moves from 8018c44 to fd11e7f on aaf2tbz/mullion metalsharp-2.1. That's 266 commits, with dttdrv/mullion's upstream work merged in.
- MetalFX and DLSS: MetalFX spatial upscaling of D3D12 swap chains. Temporal and denoised upscaling are recorded in command lists. DLSS Super Resolution, Ray Reconstruction and Frame Generation run through Mullion's signed NGX core. NVAPI answers Streamline's driver, DRS and Reflex calls.
- Pipelines on compile threads: Metal compiles graphics, geometry, mesh and compute pipelines on background threads, so new effects hitch less.
- Direct3D 12 coverage:
- Conservative rasterization, barycentrics and per-vertex attributes.
- Programmable sample positions (tier 1), dynamic depth bias, GPU upload heaps, and the OPTIONS19–21 feature reports.
- Cull distances, mesh shaders past Metal's grid limit, stream output in one pass, minimum and maximum filters, and sampler feedback.
- 64-bit atomics split into 32-bit ones where possible.
- Performance: passes overlap and are encoded on several threads on Metal 4 as on Metal 3. ExecuteIndirect of dispatches runs as Metal's own indirect dispatches, with one indirect command per indexed draw. Constant buffer, sine/cosine and gradient code is faster.
- Game fixes:
- Hogwarts Legacy's typed views in structured buffer slots; Hogwarts Legacy is shown no ray tracing by default (Wine 0122), and
MULLION_D3D12_RAYTRACING=0does the same for any game. - Assassin's Creed Odyssey's R32 UAVs of typeless textures.
- Starfield's black DLSS image (typeless depth and exposure).
- Texture buffer views clamped to Metal's 2^28-texel limit (from @antoninmuller, MetalSharp-Wine#3).
- Shared textures, fences and keyed mutexes that really cross processes (from @wehnnit).
- Hogwarts Legacy's typed views in structured buffer slots; Hogwarts Legacy is shown no ray tracing by default (Wine 0122), and
- Diagnostics:
MULLION_TRACE_<CATEGORY>logs one kind of problem at a time to~/Library/Logs/Mullion/<exe>/mullion.log. A crash's flight record names the modules on the faulting thread's stack.
Direct3D 12: VKD3D-Proton-MacOS 5.0 (GRAPHICS_BACKEND=vkd3d)
VKD3D-Proton-MacOS moves from v4.5 to v5.0, through v4.8 and v4.9.
- DLSS Super Resolution, Ray Reconstruction and Frame Generation on MetalFX, with the lane's own NGX core and NVAPI. MetalFX spatial upscaling of the swap chain (
d3d12.metalSpatialUpscaleinvkd3d.conf). - MoltenVK compiles Metal pipelines on background threads (
MVK_CONFIG_DEFERRED_PIPELINES=0turns it off). The implicit pipeline cache now hits; before, it doubled in size on every launch. - Fixes for metalsharp/VKD3D-Proton-MacOS#11:
- Packed geometry shader inputs (Forza Horizon 3, Crimson Desert).
GetAttributeAtVertex(Crimson Desert).
- A God of War Ragnarök compute shader that crashed the device now converts.
- Dragon's Dogma 2 launches.
- Faster command streams: constant buffer rows, markers, barriers between dispatches, counted ExecuteIndirect dispatches and timestamps cost a fraction of what they did.
Direct3D 9, 10 and 11: DXVK-MacOS (GRAPHICS_BACKEND=dxvk)
DXVK-MacOS moves from v3.1.1-macos.1 to v3.1.1-macos.3.
- MetalFX spatial upscaling at present for Direct3D 9, 10 and 11 (
d3d11.metalSpatialUpscaleindxvk.conf). - MetalFX temporal upscaling for DLSS Super Resolution in Direct3D 11 games, with motion vectors at the output resolution.
- It runs on the MoltenVK both lanes share, VKD3D-Proton-MacOS 5.0's, which has the Direct3D 9 fixes DXVK 3.1 needs (fixed-function, render target feedback and shadow map draws).
OpenGL: WineMetalGL 3.8.0
WineMetalGL moves from 3.7.0 to 3.8.0.
- MetalFX upscaling from MetalSharp's MetalFX setting.
- A frame rate limit,
WINEMETALGL_MAX_FRAME_RATE. WineMetalGL Settings offers 60, 45 and 30 fps. - Quake III engine games (Star Wars Jedi Knight: Jedi Academy) no longer crash at startup.
- Fence waits with "wait forever" timeouts wait again. They had broken wined3d.
- Mewgenics no longer shows a white screen.
Wine
Displays and resolution
- Display modes Apple silicon reports without the "safe" flag are listed (0088).
- A game's saved resolution follows the main display when that display changed (Unity, Unreal Engine, ELDEN RING; 0102). The Witcher 3's saved resolution follows the main display and MetalFX too (0107).
Fullscreen and windows
- ELDEN RING stays out of native macOS fullscreen, which undid its resolution and screen mode changes. That's a new
NativeFullscreenMac Driver option, off for ELDEN RING, also when Steam starts it (0101, 0111). - Wine comes to the front when it shows a window (0099), and keeps the focus event of a window it makes key itself (0089).
- A hung window no longer stops other windows painting (0092), and child windows whose parent belongs to another process are drawn (0091).
Mouse and cursor
- A fullscreen game started by Steam or MetalSharp keeps the cursor inside its window, on any display layout. Windowed programs, launchers among them, leave it free (0127).
- Cmd+left click in a window locks the cursor in it or frees it.
METALSHARP_CONFINE_CURSOR=0turns off the fullscreen default.
- GCMouse raw input carries fractional mouse movement over to the next report instead of dropping it, so slow, precise moves aren't lost (0120).
wined3d (GRAPHICS_BACKEND=wine)
- The Vulkan renderer runs at feature level 10 and above on MoltenVK (0093–0098, 0100).
- BC7 2D array textures are decoded for OpenGL (0090).
- Crusader Kings II runs without wined3d's command stream thread; it stalled while loading (0125).
Games
- Star Wars Jedi: Fallen Order no longer crashes at startup. EA's overlay started an x64 thread on a native ARM64X export, which now runs its x64 export (0126, MetalSharp-Wine#4).
- Hogwarts Legacy is shown no ray tracing on Mullion and VKD3D-Proton unless its launch environment asks for it (0122).
Per-game setup and diagnostics
- A game folder's
.metalsharp/launch.local.envsets environment variables for that game. MetalSharp never writes it, so it survives MetalSharp rewritinglaunch.env(0119). - An empty
.metalsharp/tracefile in a folder turns on Wine's trace log for its programs (0115). - msync no longer keeps a file descriptor open for every in-process sync object, which games with many events ran out of (0116).
x86 emulation (FEX)
These fix games that patch their own code, such as unpackers, anti-tamper and hooks (FEX 0023, Wine 0128, MetalSharp-Wine#7):
- Code patched while another thread runs it no longer stays stale. FEX decoded a page's code before write-protecting the page, so a write landing in between kept the old code running, or a half-written instruction.
ReadFileinto code that has run works. Before, it failed withERROR_NOACCESS.- Code in an executable
MapViewOfFileview runs and is tracked for changes. It had faulted as non-executable.
FEX_SMCCHECKS accepts only none, mtrack (the default) and full, in lowercase. Any other value, such as MProtect or Full, turns code tracking off. If a game's launch.env or launch.local.env sets it, remove the line.
Thanks
- @antoninmuller, for the texture buffer limit fix.
- @wehnnit, for cross-process shared resources in Mullion.
- dttdrv, for Mullion's upstream work.
- The reporters of MetalSharp-Wine#4 and #7, and of VKD3D-Proton-MacOS#11.
Downloads
MetalSharp-Wine-5.0-arm64.zip: the Developer ID signed and notarizedMetalSharp-Wine.app. Use this one: i386 and 4K pages need it.metalsharp-wine-5.0-arm64.tar.xz: the same Wine as a relocatable folder (bin/wine). It's ad-hoc signed, so x86_64 and ARM64 only, with 16K pages.SHA256SUMS: checksums of both.
Requirements: macOS 15 or later on Apple silicon, and macOS 26.4 or later for 32-bit x86 programs.
Sources: MetalSharp Wine main (tag v5.0) pins: