MetalSharp Wine 6.5 → 7.0 Both builds carry and download MetalSharp Wine 7.0 (MS_WINE_RELEASE_VERSION, and Release CI's METALSHARP_WINE_TAG), with Wine Mono 11.3.99 on both runtimes, Edge WebView2 programs, and every Chromium-based program drawing its UI in software so none of them freezes under FEX. MetalSharp's prefix installer installs Wine Mono 11.3.99 too.
Advanced game settings (#772) Game Settings has an Advanced Settings section, collapsed until opened, for each installed Windows game, kept in ~/.metalsharp/config/game-tuning/<launcher>/<id>.json (GET/POST /game-tuning): its own environment variables (NAME=value, -NAME to remove one), DLL overrides and Windows version for its executable (AppDefaults\<exe> in its prefix, removed again when cleared), the number of CPU cores it sees, and low priority, which runs a game that keeps a CPU core busy (an old game a frame limit does not slow) at nice 10 so the rest of the Mac stays responsive. The variables go in .metalsharp/launch.local.env beside the game and its executable, which MetalSharp Wine reads however the game starts (MetalSharp's own lines there are marked, and yours are kept), and in the environment of a game MetalSharp starts itself. Steam, Ubisoft Connect, Rockstar, Battle.net, Epic, GOG, GameJolt and Windows Programs launches all apply them; the CPU core limit only reaches a game MetalSharp starts itself, not one the Steam client or another launcher starts, and low priority is also set on such a game once its process is seen.
A game as its own app in Applications (#775) A game's Advanced Settings (Steam, Ubisoft Connect, Rockstar, Battle.net, GOG and Epic games) have a Pack as .app button that puts /Applications/<Game>.app there, with the game executable's icon (or its card art). Opening it from Launchpad, Spotlight or the Dock opens MetalSharp hidden in the background if it is not running, starts the game's launcher first (Wine Steam for a Steam game, Ubisoft Connect, the Rockstar Games Launcher or Battle.net for theirs) and then the game on its last chosen graphics route. The app stays in the Dock while the game runs; when the game exits, or the app is quit from the Dock or with ⌘Q, MetalSharp stops the game and its launcher and quits again if the app opened it. Remove .app takes the app away; MetalSharp only ever replaces or removes an app it made for that game. New backend routes /pack-app/create, /status, /remove, /launch, /running and /stop; the app's launcher is Resources/tools/metalsharp-game-app.
Scrollbars in Settings and game settings Each Settings page shows a scrollbar on its right while it scrolls, and a game's settings popup fits a small window, scrolling with a scrollbar of its own. The bar follows the scroll wheel, and clicking or dragging along it scrolls there.
Installing a Windows program runs its setup Picking a setup or installer (*setup*, *install*, .msi) in Windows Programs now runs it straight away, and what it installs is added to the library when it exits. Before, the setup was only saved, hidden from the library and never started, so nothing seemed to happen; picking it again added another hidden entry. A setup picked again now reuses its entry, and a program added without a name is named by its file rather than its path.
Windows programs using Edge WebView2 (NoHesi Launcher) MetalSharp Wine installs the WebView2 Runtime in a prefix the first time a program there needs it; MetalSharp says so in a toast when a launch will ("Installing Microsoft Edge WebView2 for …"), as it takes about a minute. Microsoft Edge, its WebView2 Runtime and their updater are no longer added to the library as programs a setup installed.
DLSS on D3DMetal for Streamline games Before a launch on D3DMetal (x86_64 runtime), MetalSharp points the prefix's NGX core registry values (NGXCore\FullPath and nvlddmkm\NGXCore\NGXPath) at System32, where MetalSharp Wine gives D3DMetal's programs Apple's nvngx-on-metalfx, so a game that gets DLSS through NVIDIA's Streamline offers DLSS and Frame Generation (Assassin's Creed Black Flag Resynced). The next launch on another lane takes those values back out, so Mullion's DXGI writes its own as before. Steam, Ubisoft Connect, Battle.net, Epic, GOG and Sharp Library launches all do this.
Ubisoft Connect's Y: is your external drive When Ubisoft's games folder is on an external drive, Y: in the Ubisoft prefix is that drive's root rather than the empty games folder, so Connect's folder picker can open it and reach any folder on it (both the FEX and x86_64 runtimes). Connect's default install folder (misc.game_installation_path and installer_cache_path in its settings.yaml) is set to the games folder on Y: when it starts, unless it is already on Y:. A default through Z: (the whole Mac) made Connect measure free space on the internal disk and refuse big games bound for the external drive. On This Mac, Y: is still the games folder.
A newly downloaded game comes first in the library The library is ordered by when each game was last played or, if later, when it finished downloading, so a game you just downloaded leads until you play something else. The backend remembers the first scan that sees a Steam game fully installed (installed_at in /steam/library, kept in ~/.metalsharp/config/steam-installed-at.json); games already installed before this update keep their order, and an uninstalled game is forgotten, so reinstalling it counts as new.
Updates through Sparkle, with deltas An update to a newer version of the running build is downloaded, checked and installed by Sparkle 2.9.6, drawn in MetalSharp's own update sheet. Each release carries a .delta from its last two Sparkle releases, so an update downloads only what changed, and every update file is checked against MetalSharp's EdDSA key before it is extracted. Switching between the x86_64 and FEX builds, and updating from a release before Sparkle, still use the release's DMG. Release CI notarizes and staples the app itself, and publishes each build's .zip, .delta files and appcast (appcast.xml, appcast-fex.xml) next to its DMG. See docs/updates.md.
Keyboard navigation in the library's Steam Deck layout (#771) On the Play view, Left/Right (or A/D) move between cards, Up/Down (or W/S) a dock's worth of cards, Home/End to the first and last, and Enter plays the selected game (it doesn't stop a running one). Escape closes the open menu. A focused search field keeps its keys.
Back to Play from a Sharp Library collection (#771) The Windows Programs, GOG and Epic collections have a "⌂ Back to Play" button in their header, like Steam's collection, which returns to the page's Steam Deck layout without switching pages.
Play time for Windows programs (#771) The backend times each run of a Windows program it launched or tracks, adding it to the program's playtime_seconds in ~/.metalsharp/sharp-library/library.json when the program exits or is stopped, and setting its last_played_at; /sharp-library/running reports when each run started. The Steam Deck layout's hero shows "Played 2h 5m" for these programs, and for Steam games from their Steam play time. Game Jolt, GOG and Epic games aren't timed yet.
Cards in your own order (#771) The selected card's [...] menu in the Steam Deck layout has Move left and Move right (Shift+Left/Right or Shift+A/D do the same), on every library page. Once you move a card the page keeps your order (cardOrder in ~/.metalsharp/gpui-ui-state.json); games added later go after the ones you placed, most recent first. Reset order goes back to the usual most-recently-played order.
Settings for Windows programs and Game Jolt games in the Steam Deck layout (#771) Their hero has the game settings gear, as Steam's, GOG's and Epic's games do. A Windows program's settings rename it, edit its launch arguments, and set its own display mode, resolution and controller input (each "Shared" by default, which keeps the collection's launch preferences; POST /sharp-library/set-preferences, kept in the program's library entry and applied over the shared ones at launch), alongside MetalFX, msync and x87 acceleration (hidden on FEX, as for Steam games). A Game Jolt game's settings rename it. Settings in Collection is still on the card's [...] menu.
Windows programs launch with their launch arguments The arguments saved for a Windows program (user_launch_args, and the launch_args it came with) were never passed to it; a launch now runs the program with them.
Frame rate limit for Sharp Library games on Mullion (#771) — the game settings' Limit framerate (30, 60 or Off) shows for GOG, Epic, Windows program and Game Jolt games whose graphics engine is Mullion (DXMT), whose launches read the limit from mullion.conf like Steam's. It no longer shows for them on VKD3D-Proton, where only Steam launches apply it. D3DMetal has no frame rate limit to set.
Mullion's frame rate limit holds on both runtimes, for D3D11 and D3D12 (#792) The limit lived only in each runtime's own mullion.conf, so after switching between FEX and x86_64 the other runtime's shipped default (D3D11 capped at 60, D3D12 not) applied even with Limit framerate off: D3D11 games ran at 48 FPS on a 144 Hz display. The limit now lives in ~/.metalsharp/etc/mullion-frame-rate, and every Mullion launch writes it into the active runtime's mullion.conf for D3D11 and D3D12 alike.
Counter-Strike 2 on D3DMetal gets mouse movement in a match (#793) Its D3DMetal launches start without MetalSharp Wine's fullscreen cursor confinement (METALSHARP_CONFINE_CURSOR=0), which left it no mouse movement in gameplay; a Cmd+left click on the window had worked around it. Mullion is unchanged.
Assetto Corsa launches (#791) MetalSharp writes the registry values a game needs into its prefix before it launches, once per prefix, as Wine's per-program AppDefaults keys that reach it however it starts. Assetto Corsa's launcher finds CEF3.dll in launcher\support (AppDefaults\AssettoCorsa.exe\MonoPrivatePath, which MetalSharp Wine 7.0's mscoree reads), and the game, acs.exe, uses Microsoft's d3dx11_43 from the DirectX June 2010 runtime, which has the D3DX11CreateShaderResourceViewFromFileW Wine's lacks. With MetalSharp Wine 7.0, its menus work and races load on both runtimes.
A Wine app override that names a missing path is ignored (#779) A METALSHARP_WINE_APP_SOURCE or METALSHARP_WINE_X86_64_APP_SOURCE left set in the login environment (by launchctl setenv) made setup report that MetalSharp didn't carry MetalSharp-Wine.app. An override is now used only when its path exists; otherwise it is logged once and the app's own copy is used.
MetalSharp Wine 6.0 → 6.5 Both builds carry and download MetalSharp Wine 6.5 (MS_WINE_RELEASE_VERSION, and Release CI's METALSHARP_WINE_TAG). On FEX: the Steam client starts again after Steam's November 2026 update, Proton's per-game rules for the games Steam starts, Valve's EasyAntiCheat and BattlEye support with the Linux module host, fourteen fixes from Wine's test suite, and a newer Mullion. On x86_64: the newer Mullion and VKD3D-Proton-MacOS 5.4.
Fixed
Switching to x86_64 after an update no longer reopens the setup wizard (#769) The startup refresh rewrites the x86_64 runtime's stale DXMT manifest stamp when its files are in place. This is the fix 1.1.0's fix-x86_64-setup-loop.sh stood in for.
Switching the x86_64 app to FEX finishes setup (#774, @bondarev) When MetalSharp Wine was downloaded rather than carried in the DMG, setup's step 10 looked for the scripts, tools and rules next to the download instead of in MetalSharp.app's Resources, and failed with "Scripts/tools bundle is missing or incomplete".
Steam on x86_64 after Steam's November 2026 update (#777, @ultima9) MetalSharp keeps Steam's CEF wrapper, compatibility flags and DLL overrides on the x86_64 runtime instead of restoring Steam's own web helper, which crashed in a loop under Rosetta 2. FEX is unchanged.
Subnautica 2 on Mullion (#773) Launches with Niagara sprite rendering off (fx.EnableNiagaraSpriteRendering=0 in its Engine.ini), which removes flashing, misplaced triangles over the ocean. Other routes are unchanged, and switching route takes the setting back out.
Rockstar Games Launcher on its own MetalSharp installs the Rockstar Games Launcher into the Steam prefix when it isn't there (Rockstar's installer, run interactively), starts it without Steam, and lists the games it installed. Steam copies of Rockstar titles stay in the Steam library and launch as before. The launcher runs on D3DMetal with WFDXCompat on the x86_64 build and on Mullion on the FEX build. Stop ends only the launcher, its helpers and its games, never Steam. Games get a launch route per game, a saved executable choice and running/Stop tracking. Routes: /rockstar/status, /rockstar/launch, /rockstar/stop, /rockstar/library, /rockstar/launch-game, /rockstar/save-pipeline, /rockstar/save-executable.
Battle.net — Battle.net is back, in its own MetalSharp Wine prefix (prefix-battlenet) like Ubisoft Connect, on Connect's lane (D3DMetal on x86_64, Mullion on FEX). MetalSharp installs it from Blizzard's installer and lists installed Blizzard and Activision games, which MetalSharp starts the way Battle.net's Play does: with Battle.net signed in, the game's executable runs with -uid <uid> with a launch route per game. Migration keeps the prefix and rebuilds it like the Ubisoft prefix. Routes: /battlenet/status, /battlenet/launch, /battlenet/stop, /battlenet/library, /battlenet/launch-game, /battlenet/save-pipeline, /battlenet/save-executable.
Where games go — Ubisoft Connect, Battle.net, the Rockstar Games Launcher, GOG and Epic each install games into one MetalSharp folder on the drive you pick: ~/Games on this Mac or the top of an external drive (MetalSharp Ubisoft Games, MetalSharp Battle.net Games, MetalSharp Rockstar Games, MetalSharp GOG Games, MetalSharp Epic Games). GOG and Epic installs go into the folder when no install path is given, and ask for a location (409, needs_location) when none is set. The other three see the folder as a drive letter in their prefix (Ubisoft Y:, Battle.net Y:, Rockstar R: in the Steam prefix), mapped again each time the launcher starts. A drive letter the user mapped elsewhere is kept. The choice is saved in ~/.metalsharp/config/library-locations.json. Existing installs stay where they are. Routes: GET /library-locations, POST /library-locations/set.
Uninstall a launcherPOST /launchers/uninstall ({"launcher":"ubisoft"|"battlenet"|"rockstar"|"gog"|"epic","delete_games":bool}) stops the launcher and its games (409 if they won't stop, and nothing is removed), then removes what MetalSharp keeps for it: the Ubisoft or Battle.net prefix; only the Rockstar Games Launcher's own folders and its R: mapping in the Steam prefix, never Steam or Steam copies of Rockstar games (its registry entries stay); GOG's prefix, keeping the sign-in; Epic's game bottles, Legendary's data, sign-in and tool. Each launcher's cache, per-game bottles and saved executable choices go too. With delete_games, its MetalSharp <Name> Games folder is deleted (links not followed) and its saved location forgotten, but only if the folder is still the launcher's own real folder in ~/Games or at the top of a connected drive. Otherwise the request is refused with 409. Without it, the folder and its saved location stay, and the response's kept_games_folder names it.
Removed
Console emulators PCSX2, RPCS3, shadPS4 and SharpEmu are gone from the Sharp Library, with their backend routes. On the first start after the update, the backend deletes their data folder, ~/.metalsharp/emulators (runtimes, firmware, saves and any games stored there). Symlinks in it are removed without touching what they point to. Installers, GOG, Epic and GameJolt are unchanged.
MetalSharp 1.0.0 comes in two builds from one release. Both share the app and its updater:
x86_64 (MetalSharp-1.0.0-arm64.dmg, macOS 15+): Wine 11.17 under Rosetta, as in 0.80.0.
Arm64 with FEX (MetalSharp-1.0.0-arm64-FEX.dmg, macOS 26.4+, early access): MetalSharp Wine v4.0, a native Apple Silicon Wine 11.20 that runs x86_64 and 32-bit x86 games with FEX, with no Rosetta.
Added
The Arm64 FEX build (#744)make VARIANT=fex builds a backend that runs MetalSharp Wine from its signed MetalSharp-Wine.app. The DMG carries the app, setup copies it read-only to ~/.metalsharp/runtime, and setup installs offline from it. Its lanes:
Mullion (DXMT fork): D3D12, D3D11 and D3D10 for x86_64 games, D3D11 and D3D10 for 32-bit games, and the default lane.
VKD3D-Proton: D3D12. The D3DMetal and GPTK titles run here.
DXVK: D3D11/10/9 for x86_64 games. The D3D9 route runs here.
OpenGL: Wine's Direct3D over WineMetalGL.
Each game's route goes into <game>/.metalsharp/launch.env, which MetalSharp Wine applies however the game starts: from Steam (so cloud saves sync), a launcher, or directly. No D3D DLLs are staged in game folders. Epic, GOG, Ubisoft and GameJolt use the same routing.
A rule set per build (#744)configs/mtsp-rules-fex.toml is the regular rules on MetalSharp Wine's lanes, generated by tools/rules/generate-fex-rules.py. Games verified on MetalSharp Wine are added on top: Dragon's Dogma 2 and Red Dead Redemption 2 on Mullion, God of War Ragnarök on Mullion and PEAK on VKD3D-Proton (both run on either lane). Each file names its build, version and schema in [rule_set].
FEX game settings (#744) The hero card's game settings have a Metal HUD switch and a frame rate limit (30, 60 or off) for the Mullion and VKD3D-Proton lanes. Settings has a ray tracing switch for the VKD3D-Proton lane: MoltenVK's ray tracing pipelines, DXR 1.1 and feature level 12_2.
Caches per lane (#744) On the FEX build, Settings shows the Mullion, VKD3D-Proton and DXVK caches with their real size, each with its own Clear. Mullion's Clear empties MetalSharp's per-game caches, then asks before clearing the Metal cache that every Mullion game shares. The VKD3D-Proton and DXVK caches that earlier FEX builds left in game folders are removed once, at the game's next launch.
Welcome to the Arm64 FEX build (#744) After an x86_64 install moves to the FEX build, the library shows a three-page welcome once. It covers early access and how to report bugs, the new graphics lanes, and Get Into It.
Switching builds (#744) The updater installs the other build at the same version, and on the FEX build, Settings → Updates offers the x86_64 build as a switch. Moving to the FEX build converts every Wine prefix (Steam, GOG, Ubisoft, bottles), keeping an x86_64 backup. Moving back restores it. A FEX DMG installed by hand gets the same conversion.
Changed
Migration paths (#744) Migration decides from the build it runs, the build that set up the home (runtime_variant in setup.json) and its version:
x86_64 -> x86_64 updates take the regular migration.
x86_64 -> FEX takes the full conversion.
FEX -> FEX updates (1.0.0 -> later) install the new MetalSharp Wine and runtime pieces, with no prefix conversion.
While a migration is pending or running, the backend's startup MetalSharp Wine refresh waits, and an install lock keeps the two apart.
Recovery reinstalls your build (#744)update.sh --recover on the FEX build reinstalls the FEX DMG and its MetalSharp Wine, at its own version too. The x86_64 build's recovery is unchanged.
MetalFX starts off (#744) MetalFX upscaling is off until it is turned on, on both builds.
Release (#744) The release builds the FEX DMG beside the x86_64 one, pinning MetalSharp Wine v4.0 against its SHA256SUMS. A failed FEX build no longer blocks the x86_64 release. PR CI also builds and tests the FEX backend.
Folder access (#744) The app explains its requests for Documents and external and network drives. The FEX build asks for them at the first Wine Steam start, so games' saves and external Steam libraries are reachable.
Fixed
Deadlock launches (#741, #742) Direct game launches wait until Wine Steam has logged on, so a Steamworks game no longer quits when it starts while Steam is still signing in. Deadlock (1422450) gets a D3DMetal rule (about 90 FPS at 1440p on an M4 Pro). Thanks to Mohamed Elghandour (@MohamedElGhandour).
Force Quit leaves no zombies (#744) Force-quit reaps the games it drops from its list.
What's new before updating (#733) An available update's release notes open in a What's new window, rendered from the release's Markdown (headings, lists, tables, code, links), from the update banner and from Settings → Updates.
Choose the 1.0.0 build (#733) When a release carries both builds, Download & Install asks which one to install: MetalSharp Arm64 with FEX (native Apple Silicon Wine, x86 games through FEX) or MetalSharp x86_64 (the current Wine).
Library Layout setting (#736) Settings → Backend → Library Layout chooses Steam Deck (the featured game with its dock, as before) or Grid (the View all collection). The library opens in the chosen layout at every start, and switching it switches the library behind Settings too. Saved as libraryLayout in gpui-ui-state.json.
x87 acceleration for every pipeline (#736) The hero card's game settings have an x87 acceleration toggle (next to msync). On, every launch gets Rosetta's x87 sidecar (ROSETTA_X87_PATH, bin/x87sidecar), whatever its graphics pipeline (DXMT, VKD3D, D3DMetal, Wine) and Sharp Library apps too; off, only the D3D9 route has it, as before. Saved as x87Acceleration in configs/config.json (/config), off by default.
macOS 26.4 notice for the Arm64 build (#733) Choosing Arm64 with FEX shows that it needs macOS 26.4 or newer and the Mac's own version, with a one-click switch to the x86_64 build. The backend reports fex_recommended, fex_min_macos and macos_version from /update/check.
Changed
The FEX update is no longer limited to macOS 27 (#733) The backend's macOS 27 block is gone; below 26.4 the app recommends x86_64 but lets the user continue. Settings' separate Update to FEX row is replaced by What's New.
Runtime bundle: WineMetalGL 3.7.0, fonts and innoextract (#734)metalsharp-runtime.tar.zst carries WineMetalGL 3.7.0 (core, Wine module and x87sidecar), Liberation 2.1.5 built as Arial, Times New Roman and Courier New (copied with Tahoma into new prefixes' C:\windows\Fonts by wine.inf), and an arm64 innoextract 1.9 in bin/.
Fixed
Red Dead Redemption 2's first launch (#737) RDR2 needs the Rockstar Games Launcher, which Steam installs on the game's first run, so its first launch from MetalSharp always failed: with no launcher yet, RDR2.exe started directly, reported "a serious issue" and exited. When RDR2 (or GTA V Enhanced) is first found installed, the backend now prepares its launcher route in the background once (.rockstar-prepared in its bottle): the D3DMetal DLLs for the game and, on D3DMetal, RDR2's DX12 system.xml. Until the launcher is installed, launching goes through the Wine Steam client started on D3DMetal, whose environment carries WFDXCompat's launcher companion, so Steam installs the launcher and it runs; once it is installed, launches start it directly as before.
Nothing launched after upgrading to macOS 27 (#735) Upgrading to macOS 27 can leave Rosetta 2 uninstalled, and MetalSharp's Wine is x86_64, so every launch failed until a fresh install re-ran setup's Rosetta step. At startup the backend now records the macOS major version, and when it reaches 27 or changes there (or nothing was recorded yet), it reinstalls Rosetta (softwareupdate --install-rosetta --agree-to-license) even if it looks installed. The version is recorded only after a successful install, so an offline attempt retries at the next start; output goes to logs/rosetta.log.
Setup's Rosetta check works on macOS 27 (#735) Setup and its dependency status looked for /Library/Apple/System/Library/LaunchDaemons/com.apple.oahd.plist or an oahd on the command path. macOS 27 has neither (oahd is in /usr/libexec/rosetta), so setup reinstalled Rosetta every time and the dependency status relied on oahd running. Both now check that x86_64 code runs (arch -x86_64 /usr/bin/true).
Setup no longer requires metalsharp-opengl.dylib (#735) The published runtime bundle no longer carries the old sidecar, which nothing loads, so setup from it stopped at "Runtime assets are missing"; installs worked only because the 0.79 DMG ships an older runtime that still has it.
Moonscraper Chart Editor installs and runs (#734) Installing MSCE.*.Installer.*.exe from the Sharp Library no longer fails with "innoextract is required": the backend uses the runtime's innoextract before a Homebrew one. Moonscraper defaults to DXMT (on Wine's own D3D11 it overflows a stack at startup), and an install made before this moves to DXMT at its next launch. Sharp Library launches copy any of the runtime's fonts a prefix lacks into its C:\windows\Fonts, so Unity's dynamic fonts no longer leave Moonscraper's input fields blank in an existing prefix; a font already there is kept.
Non-Steam games in the library (#727) Games added to Wine Steam as non-Steam games (shortcuts.vdf) appear in MetalSharp's library automatically, with artwork from Steam's custom grid images, then SteamGridDB by name, then the game's icon. They start through Steam by default (steam://rungameid); choosing a route runs the game's executable directly. Stop works for them, and closing the game from inside clears its running state.
Game controllers through SDL (#724) The bundled SDL2 is linked into the Wine runtime so winebus uses its SDL bus. Controllers macOS exposes only as vendor-defined HID, such as an Xbox Series X|S controller on Apple's driver, now reach games as XInput and DirectInput devices.
Performance cores only for Elden Ring (#720) A small interpose shim reports only performance cores to Wine, so Elden Ring no longer oversubscribes its worker threads under Rosetta.
Changed
Local IPC over Unix sockets (#726) The backend API, the Steam bridge and the in-game hook no longer use fixed loopback TCP ports (9274, 18733, 19384). The backend serves $METALSHARP_HOME/run/backend.sock in an owner-only directory, the Steam bridge moves to run/steam-bridge.sock (host ABI 2.0), the unused NT IPC bridge is removed, and the backend accepts only native-client requests.
WineMetalGL is MetalSharp's OpenGL (#716, #722) Every launch uses WineMetalGL (the runtime bundle now carries 3.2.0). Dead Cells' and Mosa Lina's OpenGL loaders get the later GL entry points they require.
Start Steam waits for a cold start (#727) Up to 30 s instead of 12 s before reporting that Wine Steam did not become ready; the app allows 60 s for the request.
DYLD_INSERT_LIBRARIES reaches games (#719) The metalsharp-wine wrapper restores it from METALSHARP_DYLD_INSERT_LIBRARIES, since macOS strips DYLD_* variables when it runs the wrapper.
Fixed
Steam's UI never appeared after a Steam client update (#727) When a Steam update installed a new steamwebhelper.exe, MetalSharp's webhelper wrapper deployment deleted it and kept the previous webhelper, which cannot talk to the updated client: the UI loaded its JavaScript and stalled. A new Steam webhelper now always replaces the kept copy, and Start Steam, the update migration's last step and Fix Steam restore a stale one from Steam's downloaded update package, checked against Steam's client manifest.
Portal launches from MetalSharp (#727) Portal starts through the Steam client.
Start Steam when the Steam helper app is refused (#725) When LaunchServices refuses MetalSharp Steam.app (a quarantined or launch-disabled bundle), Wine Steam starts directly, and the issue log records the launch's real error.
DOOM (2016) (#722) Launches DOOMx64.exe on its OpenGL 4.5 renderer instead of DOOMx64vk.exe -vulkan, which fails on MoltenVK.
A game closed from inside stops showing as running (#716) The running list no longer adopts an unrelated Wine program once a direct launch's process is gone.
Updater install progress (#715) The progress bar no longer jumps backwards while the update closes MetalSharp and stops the old runtime.
Ubisoft Connect login blocked by bot protection (#718, #723) After submitting credentials, a fresh login landed on DataDome's "Access is temporarily restricted" page, which judges the browser by its WebGL GPU. Connect's WebGL ran on SwiftShader (a headless browser's renderer), and 32-bit Connect's D3D11 (Wine's wined3d) reports a GeForce GTX 470 that no current Windows driver supports. Connect's Chromium now composites in software as before, but runs WebGL on ANGLE's D3D11 (--disable-gpu-compositing, --use-angle=d3d11 instead of --disable-gpu, --disable-d3d11 and SwiftShader WebGL), and the Ubisoft prefix gives UbisoftConnect.exe, upc.exe and Uplay.exe wined3d's AMD Radeon RX 6800 XT IDs (AppDefaults\<exe>\Direct3D, 1002:73bf), the GPU that let the reporter log in. Games in the prefix keep their own adapter.
Docs
Fix a Broken Updatedocs/Fix a Broken Update.md and the README link the recovery steps for an in-app update that left MetalSharp closed.
README Clearer project description and launch instructions, updated acknowledgements, and a Hall of Fame for outside contributors.
Space theme — a clean galaxy theme with its own spiral-galaxy picker icon: deep-space indigo surfaces and page background, starlight-violet accent and lavender text, a cosmic blue → violet → nebula magenta chrome spectrum on violet-black header and footer ink, and a purple underglow beneath the library dock's cards. Page background, hero/dock fades and chrome ink are now per-theme (page_bg, page_bg_raised, chrome_ink); every existing theme keeps its exact colors.
Persistent artwork cache and new chrome (#709) — resolved artwork is recorded in ~/.metalsharp/cache/gpui-artwork/index.json, so relaunches show cards and heroes immediately; cached art refreshes in the background, fetches run on their own thread pool, and a Steam Art Manager change refreshes only the affected games. Custom grid art can be any image format, and the header and footer get chrome bars and new icons.
Changed
License changed to AGPL-3.0-or-later (from PolyForm Noncommercial 1.0.0).
Ubisoft Connect header button After Launch Ubisoft, the header's primary button becomes Stop Ubisoft (with the Ubisoft icon) and the Steam start/stop action moves into the dropdown, instead of leaving Stop Ubisoft hidden in the dropdown. Stopping Ubisoft, or the status poll seeing Connect closed, restores Start Steam as the primary button.
Bundle tars come only from the bundles release Stop tracking the stale app/bundles/metalsharp-graphics-dll.tar.zst (an M12-era build) and app/bundles/fnalibs.tar.zst (an older build than the release), which were force-added past the app/bundles/*.tar.zst ignore rule. Because CI only downloads a bundle when app/bundles/<asset> is missing, the tracked copies meant CI never tested the published assets. PR CI's D3D12 gate no longer copies the retired dxmt-m12 lane.
D3DMetal Steam launcher handoff EVE Online's launch path (start Wine Steam with the D3DMetal environment, stage D3DMetal DLLs next to the game client, hand off through steam://run/<appid>// with Chromium GPU-off switches) is now a small table of launcher-gated games instead of EVE-only code. Assassin's Creed Odyssey (812140) now uses it too, replacing its Ubisoft Connect first-run crash-reporter retry monitor. Odyssey's running detection and Stop (which also stops Ubisoft Connect) are unchanged.
Fixed
grid overflow (GHSA-38c5-483c-4qqp) GPUI's layout engine pins grid 0.18 (gpui 0.2.2 → taffy 0.9.0), and the fix shipped only in grid 1.0.1; a vendored grid 0.18.0 with the upstream fix backported is patched in.
Grand Theft Auto V Enhanced on D3DMetal and VKD3D Starts the Rockstar Games Launcher directly like RDR2. On D3DMetal the game crashed in System Init (ERR_GFX_D3D_NOD3D12) because D3DMetal's d3d12.dll never loads a d3d12core.dll and this Agility SDK title requires one; GTA now loads d3d12.dll through WFDXCompat's D3D12 frontend from a new per-game wfdxcompat-agility lane, patched to load d3d12core.dll at load time for apps that export D3D12SDKVersion/D3D12SDKPath. On VKD3D the game keeps its own route and WineForge's launcher policy moves only the launcher onto D3DMetal. GTA5_Enhanced_BE.exe is renamed to GTA5_Enhanced_BE.old and replaced by a copy of GTA5_Enhanced.exe so the launcher starts the game without BattlEye; the same anti-cheat stub swap is restored for Elden Ring and Armored Core VI (start_protected_game.exe, lost when the Rust backend was removed), and the copy is refreshed after game updates or Steam verify.
Red Dead Redemption 2 and the Rockstar Games Launcher on D3DMetal and VKD3D The launcher draws its UI with D3D10.1 and exited about 3 s after start because D3DMetal lacks DXGID3D10CreateDevice. The graphics bundle now ships WFDXCompat's launcher companion (Graphics/dll/wfdxcompat/), setup stages it to ~/.metalsharp/runtime/wfdxcompat/, and the D3DMetal route sets WFDXCOMPAT_RUNTIME_DIR so MetalSharp's Wine loads it for Launcher.exe and SocialClubHelper.exe. RDR2 now starts the launcher directly (with Wine Steam running) instead of through a Steam handoff that lost the route environment; both routes run the launcher on D3DMetal, VKD3D passes -api Vulkan with its MoltenVK lane, and D3DMetal switches system.xml to kSettingAPI_DX12 before each launch.
Ubisoft Connect client performance Start Ubisoft Connect with the same Chromium switches EVE Online's launcher uses (--disable-gpu, --in-process-gpu, software WebGL through ANGLE), so its CEF UI no longer runs a GPU process under D3DMetal. Applies to Launch Ubisoft, the post-install launch, and the client start before a Ubisoft game.
Docs
Docs simplified into eight canonical files (#707) About 40 first-party docs collapse into docs/README.md, a user guide, architecture, compatibility and contributor docs, with one route table, one launch flow and one ~/.metalsharp layout.
CI (#706, #708) GPUI Preview checks out submodules for the host runtime build; the PR readiness checklist workflow is removed.
Graphics routes for every library and installed programs in Sharp Routes are staged for Steam, GOG, Epic and GameJolt games on route save and launch, and Sharp adopts installed launchers and games.
Install owned Steam games from Collection Through steamcmd.
GOG and Epic sign-in popups Provider sign-in popups open inside the GOG and Epic sign-in windows.
Settings links The Steam Web API and TheGamesDB key pages are linked from Settings.
Changed
Native GPUI app replaces Electron (#703) MetalSharp's desktop app is now a native GPUI application with the same behavior as the Electron app it replaces: it drives the same C backend with the same routes, setup flow, library, settings, Sharp Library, storefront sign-ins, streaming panel and updater. The release DMG packages the GPUI app (MetalSharp.app, Developer ID signed), and the Electron app is removed.
Steam window identity The Wine Steam client starts through a small MetalSharp Steam.app helper, so its windows and Dock tile carry the MetalSharp Steam icon instead of MetalSharp's.
Fixed
The Elder Scrolls V: Skyrim Special Edition Launches SkyrimSE.exe instead of its launcher, and NPC dialogue (xWMA) plays through FAudio's Windows build, installed for Skyrim only.
AMID EVIL Launches through the Wine Steam client, where it starts reliably.
Saved bottle routes A saved DXMT route is honored when saving, launching, checking readiness and diagnosing, and a <Name>Launcher.exe next to <Name>.exe no longer wins on directory order.
Steam start and stop, uninstall, shutdown and browser logins Fixes for Steam start/stop, a crash on uninstall, slow app shutdown and in-app browser logins.
Runtime and release packaging (#705) The pinned ntdll.so again carries the x87 cooperative hook that release bundle verification requires, GPUI Preview CI builds the host runtime library it packages, and release signing on the self-hosted runner keeps the login keychain searchable.
Per-game executable selection Choose and persist an installed Windows game's .exe from Steam/Ubisoft hero settings or the GOG/Epic game card. Choices are validated to stay within the game's install folder and are applied on subsequent launches.
Changed
Dependency updates (#695, #696, #698, #699)@types/node, Vite, marked and Prettier.
CI (#693) The runtime-routes test tolerates the backend's SIGCHLD handler reaping its child first.
Fixed
Baldur's Gate 3 launch and stop (#688) Defaults to D3DMetal with a plain Steam handoff, selects bin/bg3_dx11.exe, migrates bottles from the old DXMT default once, and Stop and Cmd+Opt+Q end both the Larian launcher and the game.
In-app updater recovery (#690, fixes #689) Stable updates hand off to the verified recovery installer (update.sh --recover) after download, instead of the direct-DMG path that could leave MetalSharp closed without restarting.
Storefront executable selection and Ubisoft visibility (#694) BeamNG.drive uses its 64-bit executable on Steam, The Witcher 3 launches witcher3.exe instead of REDlauncher on Steam, Epic and GOG, and an installed Ubisoft copy is no longer hidden by an uninstalled Steam entry.
Sharp Library Open Folder (#700)Tools → Open Folder opens the selected app's bottle prefix in Finder, replacing the broken Add Asset flow.
fast-uri host confusion (#691, GHSA-58mr-gqgx-xq4g) The override moves to the patched 3.1.7, with a regression test.
Docs
Supported games and READMEGAMES-SUPPORTED.md and README updates.
Ubisoft Connect library support Launch/stop Ubisoft Connect in a dedicated D3DMetal-configured Wine prefix, map a writable external volume as Y: for game installs, discover locally installed games without account/API access, extract executable icons asynchronously into a local cache, and save/apply per-game graphics routes. Selecting a route stages its DLLs beside the chosen game executable; official Ubisoft page artwork is preferred for mapped titles, then SteamGridDB artwork is resolved with the saved Steam Art Manager API key if Ubisoft art is absent/unavailable, with local executable icons as the final fallback. Runtime migration preserves the Connect prefix and rebuilds Wine drive mappings. The user confirmed Far Cry 6 launches; other Ubisoft titles remain unverified.
Fixed
Marvel Rivals launch lifecycle Route Steam App ID 2767030 to D3DMetal by default through a Steam -windowed handoff, rediscover its detached game PID, and target its installed game processes for Stop and Cmd+Opt+Q.
Generic Wine process tracking Recover game status from MetalSharp-managed non-Steam Wine executables when a launcher PID is lost, and let Stop/Cmd+Opt+Q kill those fallback processes.
Cyberpunk 2077 executable selection Prefer bin/x64/Cyberpunk2077.exe for D3DMetal launches instead of relying on filesystem traversal that can select the RED launcher.
Ubisoft library/search lifecycle Use the installed-game display name from Ubisoft's local uninstall registry, make search focus the matching hero game, keep Ubisoft Connect separate from Assassin's Creed Odyssey process detection, and retain Connect's tracked PID through its launcher-to-client handoff.
Ubisoft game process tracking Rediscover live Ubisoft game PIDs from the exact executable command and install-directory working directory so Stop and Cmd+Opt+Q target the game, not the Connect client.
Ubisoft game launch selection Ignore support/redistributable folders when selecting the game executable so launch and D3DMetal staging don't target bundled VC redistributers.
Steam Launch with D3DMetal Env Launch Steam with D3DMetal Environment so Steam can use it naturally without work-around hacks.
EVE Online Fix EVE Online Launcher loading and x64 client hand-off.
Launcher routing and artwork fixes, Sharp Library/setup polish, D3D9 route documentation, and the Age of Empires IV executable-selection fix.
Added
D3D9 launch route Documented the D3D9 option in the engine routes table and compatibility guide; added compatibility entries for Blasphemous 2, Balatro, and Assassin’s Creed Odyssey.
Assassin’s Creed Odyssey route Launch it through Steam using D3DMetal.
Epic artwork fallback Use TheGamesDB artwork when Epic metadata has no usable image.
Fixed
Age of Empires IV executable selection Steam App ID 1466860 now prefers RelicCardinal.exe over competing executables such as EssenceEditor.exe. This selects the intended executable; it does not establish that the game successfully starts.
Epic graphics pipeline setup and launch Repair Epic pipeline configuration and ensure launches use the selected route.
GOG Play and graphics routing Restore Play behavior and selected-graphics-route handling.
Native macOS Steam launches Route native macOS titles through the host instead of Wine.
Sharp Library executable routing Select and launch the intended executable.
Helldivers 2 launch directory Launch from the game install root.
Legacy updater recovery Repair installations stuck in the older update/shutdown flow.
Changed
Polished Sharp Library and setup flows; refreshed the game compatibility page, engine-route descriptions, installation guidance, and README release links.
Updated internal application, backend, and native project version metadata to 0.74.0; included the release dependency batch.
Sunshine/Moonlight streaming, hardened migration verification, and setup-wizard recovery fixes.
Added
Game streaming Stream games to mobile devices through Sunshine and Moonlight, with bounded blocking operations, status re-arbitration, listener cleanup, and permission/process handling.
Palworld compatibility entry.
Fixed
Setup wizard completion Restore the final “Launch MetalSharp” reference, correct the invalid page index, and remove the obsolete VC++ setup step.
VC++ migration/setup Make installation asynchronous, make setup tests repeatable, recover from orphan installers, reject out-of-range PIDs and unsafe names, and handle EPERM as an alive process.
Migration verification Pin the DXMT bridge signature/CDHash, use strict signature verification, and remove content verification that rejected valid preserved data. Existing Steam/GOG prefixes no longer receive the migration wineboot pass.
Streaming controls Fix the Stream button’s drag-region hit target and restore the absolute curl path.
Window/theme behavior Disable High Resolution (Retina) by default, reset corrupt saved window geometry, and correct light-theme chrome.
Docs
Refreshed supported-game entries and README installation/quick-start images and instructions; clarified the VKD3D route.
Batched dependency updates for marked, Biome, @types/node, unplugin-icons, and Vite.
Major library redesign and runtime-routing cleanup, with a first-launch experience, Steam Art Manager, Wine/OpenGL work, setup improvements, and release hardening. The version was deliberately advanced from 0.61.0 to 0.70.0 to mark the major product update and complete visual overhaul—not because releases were omitted.
Added
Library redesign Themed top bar, collections/actions, settings overlay, refreshed logs and Sharp Library surfaces, themed header menus, and improved draggable window regions.
Steam Art Manager Bundle the companion tool, add its launcher/control, remember the Steam path and API keys, provide first-use guidance, automatically refresh library artwork when Steam grid art changes, and let custom hero artwork override CDN art.
Quit guidance Slide in a launch overlay reminding players to use Cmd+Opt+Q; leave Steam running when the shortcut force-quits games.
Startup and updater UX Add the first-launch video, updater download progress and periodic release checks, and Markdown-formatted release notes.
Steam setup and runtime support Show installation stages, prepare Wine wrappers before launch, make preflight actionable/best-effort, and bundle required archive/icon/zstd tools.
WineMetalGL OpenGL lane Port the host OpenGL driver to Wine 11.17, record its host-driver hash, and select the appropriate ntdll variant for each Wine launch.
Unified gated ntdll runtime Promote the unified runtime and ship the Wine GSBASE build for Unity/DXMT; update the pinned runtime hash for the Overwatch-safe rebuild.
Game compatibility and launch routing Add/default routes for Witcher 3, Master Duel, Team Fortress 2, Ori, Nidhogg 2, and selected D3DMetal titles; select the CS2 executable correctly.
Steam route persistence Create bottle manifests when saving routes and provide a 32-bit DXMT native-host bridge.
Wine Mono 11.3.0 bundled by default, with licensing documented.
macOS 14 support work Target runtime components appropriately and harden the DXC container shim.
Installation Clear Gatekeeper quarantine during install steps, use bundled tools without requiring Homebrew, and improve Steam installation setup.
Changed
Consolidated graphics route names and behavior: retired M12 runtime checks, folded DXVK fallback into VKD3D, rebuilt the DXVK lane for x86_64, and retired its i386 lane; preserve the selected ntdll variant and route-specific graphics environment.
Retired outdated documentation/roadmaps and rewrote the install, route, Wine, D3DMetal, and Vulkan guidance; added a Steam repair guide/script.
Refreshed the brand icon, default Electron window size, Retina behavior, Steam display scaling, and draggable header controls.
Updated release and dependency workflows; dependency updates included Electron 44, marked, Iconify/Lucide, Biome, and the Vue Vite plugin.
Backend routing and games Reconcile Steam graphics routes with D3DMetal launches, preserve the correct route when switching, and ensure the Helldivers 2/CS2 launch paths are correct.
Updater/release Publish progress atomically, derive DMG version from package metadata, report backend-version mismatches, narrow verification extraction, synchronize graphics/ICD checksums, and accept the DXMT manifest emitted by setup.
Hand-written C backend becomes the active runtime; adds third-party launchers, GameJolt, emulators, and signed-runtime migration/release work.
Added
Hand-written C backend Make it the active runtime reference, implement launch/runtime and Steam-sync behavior, and add backend parity comparison/normalization tests and crash reports. Remove the Rust backend after parity work; remove obsolete “basic” file suffixes and local absolute rule paths.
Launcher integrations Add GameJolt and isolated Epic, Ubisoft, Rockstar, EA App, and Battle.net launcher/library support; add a native Epic library. Battle.net was subsequently removed as a supported launcher and isolated on Wine Staging while that integration was evaluated.
Emulator libraries Add managed PCSX2, RPCS3, and SharpEmu environments; add experimental shadPS4 library/capability manifests and safe update handling; add emulator library sidebars and setup actions. Remove the dormant RPCS4 provider, simplify emulator actions, and accept PS2 images.
FEX update channel for runtime updates.
Theme polish for Beach and Forest themes; official PS3 firmware link/button and firmware onboarding for RPCS3.
PolyForm Noncommercial licensing and community health files.
Changed
Keep the C backend alive for long operations; keep it alive during the update handoff while managed Wine processes are stopped; make migration and ordinary relaunch paths work with the new backend.
Preserve GOG installation state when stopping and correctly resolve installed GOG games for launch. Keep the dedicated Sharp Library launcher setup out of the general setup flow.
Add native tool paths and bundle/runtime hash refreshes; document Homebrew-tap installation and compatibility testing.
Refresh release bundles from the published manifest, pin signed-runtime hashes, split and scan release DMGs with VirusTotal, and update CI for Rosetta/native C-backend and PCSX2 archive/capability tests.
Batch Electron, Biome, Node type, and Rust libc dependency updates.
Fixed
Steam library Refresh library contents and executable routing, preserve external-library/game sync, fix TF2 executable selection and Steam setup, and align C migration with Rust preservation behavior.
GOG and launchers Preserve GOG install state after Stop; resolve installed GOG games; repair GOG auth artwork and Mono persistence; make launcher environments isolated.
Emulators Make PCSX2 capability and PS2 image indexing exact; complete RPCS3 folder onboarding; avoid redundant shadPS4 manifest writes and clean interrupted updates safely; bind imports to detected runtime capabilities.
Migration/runtime Match C migration behavior to existing data preservation, normalize quarantined assets, use fixed macOS tool paths for bundle staging, and keep signed-runtime verification aligned with release bundles.
Standalone VKD3D-Proton lane, global game controls, route-aware library refresh, and the glass-header/theme experience.
Added
Independent VKD3D-Proton lane for D3D12 through Vulkan/MoltenVK, with pinned runtime payloads staged during install/migration and protected from DXMT route contamination.
VKD3D route support Deploy DXVK components for D3D9/10/11, configure MoltenVK and DXVK runtime options, add diagnostics and dxvk.conf, and route games that resolve to M12/VKD3D through the lane. Keep an explicit DXMT rollback and seed DXMT configuration/markers for DXMT bottles.
Global Cmd+Opt+Q to force-quit running games while leaving Steam alive.
Sidebar controls for MetalFX scale (1.75, 1.50, or off), Msync, and controller input; bundle the XInput controller shim DLLs.
Library lifecycle refresh Refresh library state automatically and return a stopped game’s card to Play, including when a game exits externally; discover installed games in shared external Steam libraries and refresh after installs.
Glass migration wizard and redesigned setup wizard; refresh the library/logs UI, theme picker, and game cards.
Themes Add Banana, Lava, Beach, and Xray; make the picker scrollable and remove the developer theme from normal selection.
Noncommercial license and runtime installer, plus community health files.
Changed
Move the HTTP backend from tiny_http to multi-threaded Axum with a blocking pool.
Replace M9/M10/M11/M12 labels with the public graphics route names; retire M9 and remove M12 from user-facing selectors.
Keep VKD3D’s Vulkan/MoltenVK surface in its own runtime lane and never deploy it into DXMT system32; avoid re-running the VKD3D installer during bottle saves.
Update compatibility rules and pipeline labels, including the Sons of the Forest DXMT route and the 9 Kings VKD3D diagnostic override.
Fixed
Process control Restore force-kill ownership checks for Wine argv, parse Windows executable arguments correctly, register the /game/running IPC route, poll registered PIDs, and keep library cards in sync with game exits.
Steam library Show the library before slow scans, make /scan single-flight, detect new installs promptly, make Refresh perform a full scan/reload, sync external-library games, hide Wine Steam desktop shortcuts, and stage the Steam runtime for D3DMetal bottles.
Protected launches Prepare D3DMetal protected games without blocking non-D3D12 titles on Agility SDK setup.
Pipeline transitions Quarantine stale VKD3D d3d12core.dll when switching to DXMT and self-heal dxmt.conf.
Security and dependencies Patch the undici Dependabot alerts and tighten release/DMG bundle handling.
Major security/stability hardening across the local API, process control, Wine compatibility shims, DXMT/VKD3D routes, installer/updater, and release packaging.
Added
VKD3D-Proton public lane Rename M12 to VKD3D, retire the separate M9 route, unify M10/M11 as DXMT and their 32-bit variants as DXMT (32-bit), and use DXVK-MacOS for D3D9/10/11 on the Vulkan route. Keep DXMT and VKD3D payloads separate; pin MoltenVK/DXVK assets, configure Vulkan, deploy the expected DLLs, and add route/bundle checks.
GPTK 4 beta 2 optional overlay with allowlisted repair endpoint and conditional download; retarget the optional overlay to GPTK 3.0 and refresh its state after D3DMetal settings changes.
EAC support substrate Package the Linux EAC substrate, stage it across installs/migrations, add opt-in game-card controls and protected-game rules, validate assets on clean builds, and verify protected launcher files remain untouched.
Force-quit and stuck-game recovery Add backend process-tree ownership, detach/reap Wine helper processes, and allow the UI to evacuate hung games safely.
FNA/Mono and native host compatibility Add a managed-executable bridge and harden Win32, loader, networking, audio, and threading behavior (details in Fixed).
Changed
Remove Developer SDK packaging and requirements from DMG/release manifests and stop verifying the retired DXMT-VKD3D SDK lane.
Use a version-aware WineMetal shader configuration and rebuild DXMT for the supported macOS/Metal baseline.
Update setup/migration screens to glass styling and redesign setup with the application logo, Rethink Sans, glass, and foil styling.
Batch Electron, Vue, Vite, Iconify, Biome, Rust networking/database, and support-library dependency updates; restore formatting gates in CI.
Fixed
Local API and process security Authenticate local backend requests; bound request bodies; validate Steam AppIDs; constrain process termination to MetalSharp-owned executable/process trees; fix game-process argv ownership; reject unsafe GOG auth flags; prevent local path traversal in Sharp Library artwork/cover writes; reject symlinked cover directories; guard uninstall targets; safely handle privileged updater paths and DMG ejection; verify downloaded installer artifacts.
Updater/install/release Compare prerelease versions correctly, publish DMG versions from package metadata, surface backend-version mismatch as an error, clean failed Steam staging prefixes, never delete a Steam prefix before reinstall succeeds, inject the EAC substrate into the scripts-tools bundle, verify pinned bundle checksums, and harden package preparation.
Win32/kernel32/loader Back SRW locks with mapped pthread state; fix LoadLibrary resolution, GetModuleFileNameA, RtlLookupFunctionEntry null-image handling, environment-variable shims, UTF-16 entry points/string termination, PE relocation/import/export/resource bounds, module find-data filenames, thread exit/completion reporting, named-pipe directory/handle behavior, and per-call pipe handles.
Networking/audio Implement WSAWaitForMultipleEvents over real events, honor TIMEVAL in select, bound GetAdaptersAddresses, guard DirectSound buffer lifetime, synchronize CoreAudio callback state, bound stereo render output, clamp X3DAudio matrix stride, and release Mach send rights on every error path.
FNA/Mono and launch Handle LoadLibrary failures and UTF-16 names; preserve borrowed handles in CloseHandle; pass managed executable parameters through the mscoree bridge; constrain FNA game directories; stop returning the game directory when executable resolution fails; scope Process Manager shutdown; and restrict teardown to owned process trees.
API and settings Atomically persist settings and synchronize state; remove duplicate Rust-bridge listener lookups; isolate compatibility database fixtures; add tests for the security and runtime fixes.
Stabilizes the new Mono/FNA and VKD3D launch routes, improves game-stop controls, and adds consented developer diagnostics.
Added
Cmd+Q game stop and UI launch controls; center sidebar launch controls and update registered-process polling so cards return to Play on game exit.
PostHog developer diagnostics for consented diagnostic reporting.
Reminiscence M11 compatibility rule; Stardew Valley routes through the FNA/Mono path.
Fixed
Mono/FNA Restore Steamworks before FNA handoff, stage Terraria launcher by executable name, support Terraria WinForms/ReLogic.Native shims and Stardew Steamworks.NET, route .NET Core games correctly, repair wrapper/Mono/.NET 6/GDI+ and Unity launch regressions, and guard runtime directory and DLL staging.
VKD3D/MoltenVK Synchronize VKMT/MoltenVK on install; resolve its lane before Wine’s own libraries; use the validated VKMT stack to boot Control; deploy DXVK dxgi + d3d11 for D3D11-on-VKD3D; direct-launch with real Steam files; refresh caches/diagnostics; isolate system32 deployment and freeze the bottle route during save.
DXMT Select macOS-appropriate Metal shader versions.
Pipeline state Isolate graphics DLLs when switching routes and mutate runtime pipeline rules consistently with bottle state.
Preserve the saved theme on startup and fix Steam launch/bottle-spinner races.
Update js-yaml and resolve Rust/clang formatting CI failures.
Introduces versioned Mono/FNA profiles, launch routing and payload deployment; adds controller and graphics controls.
Added
Mono profile discovery and routing for Unity Mono, FNA, XNA, MonoKickstart, and IL2CPP. Detect baseline versus modern Mono requirements, deploy version-matched prebuilt runtime payloads when saving a bottle, and dispatch kickstart launches without compiling at launch time.
Bundle version-matched Unity Mono, XNA, SDL3, and related runtime payloads; add readiness checks and route-specific configs.
Controller input selector for XInput/DInput shims and ship the corresponding DLLs in lib/metalsharp.
Sidebar MetalFX and Msync toggles, including MetalFX scale selection and passthrough of the selected factor.
Move the D3D12/M12 stack to VKD3D-Proton (D3D12 → Vulkan → MoltenVK), with DXMT rollback available.
Fixed
Isolate MetalFX/MSync settings and stop environment overrides from leaking into the wrong launches.
Repair bottle-save races, stale component state, migration config survival, M12 install reconciliation, and failed Wine-prefix migration cleanup.
Isolate MetalSharp’s Wine runtime from foreign launchers such as CrossOver/SakuraGiri, disable verbose Wine tracing by default, and preserve legacy OpenGL compatibility contexts.
Fix the mapped-address virtual-memory test and add the Mono-route discovery roadmap/changelog and bundle manifest updates.
MoonScraper installer support Detect Inno Setup installers, extract their payload natively, install the discovered app into the right Sharp Library bottle, and document the fallback.
Fixed
Automatically synchronize installer bottles and support WineBare installers.
Tighten Java/WebView detection so scan noise from large files does not cause false positives.
Remove an installer bottle when uninstalling its app and use standard fallback artwork.
Introduces the standalone C backend/release path and its contract tests, architecture checks, and release-bundle pipeline.
Added
Standalone C backend Create the C runtime and tests, ship it through the pinned Rust-to-C compiler, capture a standalone link manifest, force a portable SHA-2 backend, and validate Electron calls against C routes.
Backend contract suite and test-count enforcement; validate the C backend in DMG workflows and keep production DMGs on the C-only backend path.
Release pipeline restoration/hardening Restore bundle builds, refresh stale locked release bundles, validate C-only bundle setup, verify the DMG and release inputs, and make backend updater port handoff reliable.
Make macOS target architectures explicit and keep Wine test targets x86_64.
Restore CodeQL C++/TypeScript analysis and add release/build job-control contracts.
Fixed
Fix the backend contract for 0.55, Homebrew setup detection, Terminal launch, Electron backend import order, C-only installer bundle resolution, DXMT MinGW GUID formatting, and release-bundle refresh.
tools/ci/check-doc-freshness.py Warns on docs without an Updated: header or older than 120 days; also verifies CHANGELOG.md has a section for the current version. Warn-only by default; --strict makes it an error.
.github/hooks/pre-commit + README — opt-in shared pre-commit hook. Runs clang-format --dry-run --Werror, tsc --noEmit, biome ci, prettier --check, and the rules-TOML/doc-freshness validators locally when relevant files are staged.
609 default rule entries for Steam AppIDs — bulk-add of game compatibility rules for DX9/10/11/12 pipelines, sourced from Steam store data and community testing. Pipeline distribution: m9: 54, m10: 2, m11: 471, m11_32: 70, m12: 12.
Changed
Pre-commit policy: fail-hard on missing toolchains. The hook fails when required formatting, Node, or Python tooling is absent instead of silently skipping checks.
Compatibility databasedocs/compatibility/GAMES-SUPPORTED.md now documents the M9, M10, M11, M11-32, M12, and D3DMetal pipeline coverage and corrects the Party Animals AppID (1260320; the prior 1823720 was incorrect).
Fixed
Party Animals AppID correction Was 1823720 (Mail Mole); correct ID is 1260320.
Docs
Added **Updated:** 2026-07-08 headers to 37 docs that lacked a date stamp.
Archived dead/historical roadmaps to docs/archive/roadmaps/. docs/archive/README.md documents the archive policy.
Removed docs/compatibility/game-compat.md (a 4-line redirect stub pointing to GAMES-SUPPORTED.md).
M11(32)/M10(32) bottle visual fix, GOG/OAuth hardening, Wine Mono bundling, Steam DLL cache, and D3DMetal save feedback.
Fixed
M11(32)/M10(32) bottle visual dropdown (#256, #258) bottles and library cards now correctly surface the 32-bit variants; the dropdown expands only the active row, and (32) annotations appear in the right places.
GOG OAuth (#258, #259) replace the Safari AppleScript browser polling with a bundled Electron BrowserWindow helper. Restores the app icon on the OAuth window and surfaces GOG as a fully-supported library source.
Wine Mono install (#258) bundled wine-mono-11.2.0 installs asynchronously with progress; old mono is cleaned up before reinstall; wine-mono-11.2.0.marker written on success.
Steam DLL cache (#258) for steam_interfaces.txt Goldberg toggle, ensure DLLs are present and the cache is regenerated if empty/incomplete.
D3DMetal save feedback (#258) library cards now show the actual D3DMetal bottle state on save; stale manifests are normalized.
winemetal.so deploy Removed an incorrect copy of winemetal.so to system32 during i386 repair that was being overwritten on every save.
Docs
README GOG compatibility section, Discord badge, and a few wording passes.
Bottle save / DLL surface for 32-bit pipelines The i386 DXMT lanes now save bottles correctly. The previous implementation swapped DLLs but did not rebind the bottle manifest to the right bottle_id, so saves appeared to succeed but pointed at the wrong drive_c snapshot. Also resolves the (32) exe-resolution edge case where the loader would pick the 64-bit exe on a 32-bit pipeline.
32-bit DXMT routes for M11/M10, MetalFX live toggle, and Process Manager GPU overlay.
Added
M11(32) and M10(32) DXMT routes (#253) 32-bit D3D11 and D3D10 games now route through the i386 DXMT lanes. The new M11_32 and M10_32 PipelineId values are wired through the rules engine, the bottle doctor, and the graphics runtime repair path.
M11(32)/M10(32) staging + doctor The i386 DXMT lanes are staged alongside the existing x86_64 lanes, and the bottle doctor checks the right DLLs for each variant.
Process Manager performance overlay Ported from the 0.51 branch, with an interactive vcrun2019 repair button and honest CPU temperature reporting (no more kIO* shim).
MetalFX Spatial Upscaling live toggle In the Process Manager overlay, the user can flip MetalFX on/off per-process without restarting.
GPU load overlay The Process Manager now reports real GPU utilization, not the placeholder value.
Fixed
Hades + Titan Quest through M11(32) (#254) Hades and Titan Quest now resolve to the (32) exe and the bottle DLL surface checks the right DXMT files.
GOG migration metadata Preserves GOG bottle metadata across migrations.
CI bundle hook list Adds a missing line continuation in verify-bundles.sh's runtime hook list.
GOG MetalSharp Games launcher, M12 release path, D3DMetal GPTK explicit lane, dependency hygiene, and Electron theme polish.
Added
GOG MetalSharp Games launcher (#242) a fully separate GOG launcher built on the gogdl downloader. GOG OAuth now flows through a bundled Electron BrowserWindow (replacing the previous Safari AppleScript bridge). GOG prefixes are managed end-to-end, GOG cards get artwork, and the GOG install path is shared with the Steam path for compatibility surface purposes.
M12 release runtime path Release CI now installs the DXMT build tools and MinGW toolchain and verifies the M12 archive layout. The chore: bump release version script verifies all 5 version locations are in sync.
D3DMetal GPTK explicit lane#231 adds a dedicated D3DMetal lane separate from M12, with its own bottle repair actions, runtime staging, and Titan Quest M9 rule.
D3DMetal → M12 route switching Bottles can be switched between D3DMetal and M12 with the right DLLs swapped automatically.
M12 winemetal sidecar validation Release CI validates the staged winemetal.dylib and winemetal.so sidecars.
Process Manager performance + process controls The in-game overlay now has explicit performance and process controls (per-process kill, GPU usage, etc.).
Developer theme preview A new developer theme that uses neutral sidebar active text and an honest library card grid.
Changed
Library card grid Cards now lay out in a fixed 2-column grid; glass sidebar active route shimmers on route change; the developer theme is opt-in.
M12 DXIL vertex input hardening, RE4 diagnostic capture, and the M12 cube pipeline CI gate.
Added
M12 DXIL vertex input mapping Uses vertex pulling for DXIL vertex inputs (replaces an earlier "share unix winemetal" attempt that was reverted). The shared IA metadata builder is now used by both the M12 cube runner and the game launch path.
M12 fragment bindings hardened Compute binding completeness logs added; zero-draw swapchain presents classified; direct swapchain clear work recorded; command list lifecycle traced.
M12 render encode path hardened Encodes go through the new M12 render encode path.
M12 shader present path hardened And a defined M12 shader engine contract.
M12 game-local launch path Defined; a bottle repair checklist and a native repair fallback were added.
Steam prefix init without wineboot Speeds up launch on cold bottles.
DXMT winemetal migration staging Verified.
Elden M12 shader corpus Added for shader testing.
MTSP game rules + M12 fallback DLL checks Updated.
Sharp artwork fallback Uses fallback art for games missing images.
Steam secure launch args for protected games, FNA asset repair, GPTK prefix seeding, and D3DMetal offline launches.
Added
GPTK repair, launch routing, and library UI hardening (#197) GPTK repair status is now surfaced in the library UI, with a clear launch-routing decision.
FNA runtime asset repair (#198) bottles with FNA games now repair their runtime assets (fnalibs bundle) on save.
FNA asset bundle repair (release) (#199) the release DMG verifier checks the fnalibs bundle.
GPTK prefix reseeding GPTK prefixes are now seeded with the D3DMetal DLLs and reseed themselves when the prefix is regenerated.
Party Animals steam secure argsPartyAnimals (correctly appid 1260320) now launches with -steam -secure.
GTA V steam secure argsGTA5.exe now launches with -steam -secure. Rockstar runtime prerequisites (C++ redist, scripthook) are preflighted.
BeamNG M11 secure ruleBeamNG.drive routed through M11 with secure args.
Researched default launch args Epic and Ubisoft launcher bottles (and other researched titles) get default secure launch args.
Sharp Library launcher defaults The Sharp Library store launches games with sane default args; PR review state warnings are fixed.
D3DMetal offline launches D3DMetal Steam launches now default to running offline (no Steam client needed for single-player titles).
GPTK VC redist seeding GPTK prefixes now include the VC redistributable.
Mono FNA bottle save verification Mono FNA bottles are verified on save.
Changed
Steam secure launch args Deployed for PartyAnimals, GTA5, and BeamNG.drive; skipped on D3DMetal launches (which are offline).
Migration post-wineboot Steam updater dismissal The post-wineboot Steam updater is dismissed during migration so it doesn't block completion.
Install hardening, backend lifecycle, Lucide icons, uninstall, and compatibility updates.
Added
VC++ 2015-2022 runtime setup step New step in the setup wizard with x64 and x86 install cards. Downloads from Microsoft, runs via Wine /install, idempotent.
Kingdom Hearts HD 1.5+2.5 ReMIX (appid 2552430) and HD 2.8 (appid 2552440) — M11 pipeline rules, preferred EXE names, process patterns.
Lucide icons 26 inline SVGs replaced with tree-shaken unplugin-icons + @iconify-json/lucide components across 6 Vue files.
Dev-mode backend auto-restartensureRunning() auto-restarts in dev mode so binary swaps work without manual restart.
Changed
Backend lifecyclekillProcess() sends SIGTERM then SIGKILL on quit. Production ensureRunning() no longer auto-restarts — only start() spawns. cleanup() is async and awaited in before-quit.
Goldberg emulator hardened Install idempotency checks only core DLLs; steam_interfaces.txt regenerated if empty/incomplete; diagnostic logging on missing runtime.
Sharp Library Steam routingSteamSetup.exe routed to steam::install_steam() (correct ~/.metalsharp/prefix-steam/); Steam.exe routed to steam::launch_wine_steam().
Post-update migration wizard When the updater completes, MetalSharp re-launches into a migration view that preserves user data (settings, bottles, compatdata, Sharp Library apps) while installing the refreshed runtime.
VC++ and DirectX redistributable preflight Runtime doctor checks and installs common redistributables.
Fixed
FNA/Mono config templates Ships Mono config templates in app bundle, guards against empty config files.
Setup wizard welcome page Updated descriptions to match actual feature set.