- General & System Requirements
- Steam Setup & Bridge Updates
- Choosing CPU & Graphics Settings
- Game Fixes & Custom Presets
- External Drives (ExFAT & APFS)
- Non-Steam Standalone Games (.exe)
- Wine Prefixes, Save Games & Utilities
- Troubleshooting Common Issues
Positron integrates with the native macOS Steam client so you can download and play Windows-only Steam games directly inside macOS Steam (plus standalone non-Steam .exe games) using your installed CrossOver or Wine runtime. It provides a native macOS SwiftUI app (Positron.app) that acts as the single source of truth for per-game presets, toggleable game fixes, and Wine prefixes.
No. Positron discovers and uses the CrossOver (CrossOver.app or CrossOver Preview.app) or custom Wine runtime already installed on your Mac. This lets you upgrade CrossOver at any time without waiting for a hardcoded SHA-256 allowlist update.
Native macOS games (such as Cyberpunk 2077, Baldur's Gate 3, and Metro Exodus) always run natively on macOS. Positron automatically detects native .app bundles inside steamapps/common/ and excludes them from Windows compatibility routing.
Why is Steam's built-in "Properties → Compatibility" tab hidden?
To prevent conflicting settings between Steam's UI and Positron's per-game presets, Positron hides Steam's Compatibility tab so Positron.app is the single source of truth. You still get the green Install / Play button and the Windows filter in your Steam library.
- If Steam is closed when you open
Positron.app, Positron automatically updates and signsSteam.appin the background—no clicks needed. - If Steam is running,
Positron.appdisplays a top banner ("Positron Bridge Update Ready") with a single Update & Restart Steam button that installs the new bridge, re-signsSteam.app, and restarts Steam automatically.
Open Positron.app → Steam Setup and click Restore Stock Steam (or run positron steam-restore from the CLI). Positron restores your original Steam.app/Contents/Info.plist, removes the injected dylib and compatibility tools, clears the steam.cfg update lock, and re-signs Steam.app.
| Setting | Best For | Notes |
|---|---|---|
Rosetta 2 (x86_64) |
DirectX 12 games (D3DMetal), AVX/AVX2 games, 32-bit (i386) games/launchers, and games with 1 MB PE stack reserves (Fallout 76). |
Most compatible; required whenever D3DMetal is selected. |
FEX (ARM64EC) |
Clean 64-bit DirectX 11 games paired with DXMT on CrossOver Preview 27+. | Lower CPU translation overhead on supported 64-bit DX11 titles; automatically disables D3DMetal and Rosetta AVX flags. |
- D3DMetal (Apple GPTK): Required for DirectX 12 titles (The Witcher 3 DX12, Red Dead Redemption 2, Elden Ring, Atomic Heart) and Unity games that rely on
IDXGIResource::GetSharedHandlefor Media Foundation.mp4video playback (Heroes of Might and Magic: Olden Era). - DXMT: Native Metal renderer for DirectX 11 (Fallout 76, Fallout 4, Skyrim SE, Frostpunk, Dark Souls III). Fast, low-stutter, and capped at 120 FPS by default.
- WineD3D: Best for 32-bit CEF launchers (STAR WARS: The Old Republic) and classic DirectX 9 / DirectDraw games (Fallout 2).
- DXVK: Vulkan-on-MoltenVK renderer for older DirectX 9/10/11 or Vulkan titles (DOOM 2016 / Eternal).
- Msync (Mach semaphores) is the fastest synchronization primitive on macOS and is the default for almost all games.
- Esync (eventfd synchronization) is recommended for Red Dead Redemption 2 (
1174180) to prevent frame-pacing and lighting flicker under D3DMetal.
Select any game in Installed Games and scroll to the Game Fixes section in the left column:
- Use Game-Specific Fixes to toggle all patches, DLL overrides, and flags for that title on or off at once.
- Or toggle individual fixes (e.g., Witcher 3 DX12 crash & HDR fix, RDR2 anti-flicker, individual
DLL <name> = n,boverrides, orD3DM_*flags) and Launch Safeguards (Remove._files on external drives, Keep the prefix on the internal SSD, Cap DXMT at 120 FPS) independently, then click Apply Changes to Steam.
Positron stores your editable catalog at:
~/Library/Application Support/Positron/presets-catalog.json
You can also click Save to Catalog in the Installed Games footer to save your current game's settings into presets-catalog.json, or click presets-catalog.json to edit the JSON file directly.
Positron's support folder (~/Library/Application Support/Positron) is growing to 15+ GB—can I move all prefixes, runners, and images to an external drive?
Yes! Open Positron.app → Steam Drives and use the Positron Support Files & Disk Image Storage card at the top:
- Click Move Positron Storage to External Drive… and select any external drive (even an
ExFATdrive) or an existing.sparsebundle. - Automatic APFS Sparse Disk Image on ExFAT: If your external drive is formatted as
ExFAT, Positron automatically creates and mounts a dynamicPositronStorage.sparsebundleAPFS disk image on that drive (~/Library/Application Support/Positron/.mounted-storage), moves all heavy folders (prefixes,runners,external-prefixes,bridge,fonts,launchers,shortcut-icons) into it, and replaces the internal folders with lightweight symlinks. - Zero Space Wasted: The sparse disk image only uses the actual space of the files inside it, supports one-click Compact Disk Image (
hdiutil compact) and Clean Old Backups, and is automatically mounted wheneverPositron.appopens or Steam launches a game (compat_run.sh). - You can also click Move Back to Internal SSD at any time to copy everything back cleanly.
Two macOS behaviors break Windows games on ExFAT external drives:
- macOS Finder/Spotlight creates hidden 4,096-byte AppleDouble resource-fork files (
._Core.zip,._*.ba2,._*.dll) on non-APFS volumes. Many Windows games scan folders for*.zipor*.ba2and crash or enter an infinite error loop when they open a 4 KB._*file. - Wine prefixes require POSIX symlinks, hardlinks, and case-insensitive metadata that
ExFATdoes not support reliably.
Positron fixes both automatically:
- Before launching any game on
/Volumes/*, Positron cleans._*AppleDouble files usingdot_clean -mandfind -name '._*' -delete. - Positron automatically redirects external-drive
STEAM_COMPAT_DATA_PATHprefixes onto your internal APFS SSD at~/Library/Application Support/Positron/prefixes/<appid>while mapping your external Steam library as Windows driveS:.
- Open
Positron.app→ Installed Games and click Add Non-Steam Game… at the bottom of the left column. - Select the game's Windows
.exefile. - Positron assigns it a stable virtual ID, inspects its PE headers and engine DLLs to recommend a preset, and creates an isolated Wine prefix at
~/Library/Application Support/Positron/prefixes/<virtual-id>. - Adjust any preset settings or Wine prefix tools, then click Launch Game.
- Internal APFS & External-Drive Shadow Prefixes:
~/Library/Application Support/Positron/prefixes/<appid>/pfx - Save Games & Windows User Profile (
steamuser):~/Library/Application Support/Positron/prefixes/<appid>/pfx/drive_c/users/steamuser - You can open either folder in one click using Open Drive C: and Open Save Games in the Wine Prefix & Utilities panel.
Select the game in Installed Games and click Run .exe / .msi under Files, Installers & Maintenance to run any .exe, .msi, .bat, or .cmd installer directly inside that game's Wine prefix.
Positron automatically backs up the previous prefix to pfx.previous-<timestamp>, copies your drive_c/users/steamuser save games and AppData/Documents into a fresh prefix matching the new architecture, and re-stages the Steam bridge DLLs.
- Per-Game Launch & Prefix Log: Click Launch Log in the game's Wine Prefix & Utilities panel (or open
~/Library/Application Support/Positron/prefixes/<appid>/notproton-run.log). - Wine Runtime / Renderer Log:
~/Library/Application Support/Positron/launchers/<appid>/notproton-wine.log - Steam Bridge Hook Log:
~/Library/Application Support/Positron/positron-steam.log
If the game uses a 32-bit Chromium Embedded Framework (libcef.dll) launcher (like STAR WARS: The Old Republic), select Rosetta 2 + WineD3D and ensure the CEF launcher window fix toggle is ON in Game Fixes.
Unity's WindowsVideoMedia player requires IDXGIResource::GetSharedHandle and ID3D11Fence, which DXMT does not implement. Switch the game's Graphics Renderer from DXMT to D3DMetal (GPTK) on Rosetta 2 and click Apply & Play in Steam.