Bridgeplay README

README проекта с github.com/raymondchins/Bridgeplay. Одним файлом markdown: README.md.

Bridgeplay: Windows games, in your Mac's Steam

Windows-only Steam games on Apple Silicon, right inside the Steam you already use.
Same library. Same Play button. No bottles, no second launcher.

Website Stars Apple Silicon macOS 26+ License GPL-3.0

Bridgeplay is a fork of NotProton by NotProtonNot. Games run on CodeWeavers' open-source Wine, the engine behind CrossOver, and Apple's Game Porting Toolkit. I'm not affiliated with either. If CrossOver works for you, buy it: that money is a big part of what keeps Wine on the Mac moving. Bridgeplay is a hobby project I maintain part-time, so support is best-effort. Full list in Credits and Support Wine.


What Bridgeplay does: plays inside Mac Steam, experimental frame generation, DLSS answered by MetalFX, DirectX 12 on Metal, any controller, full Retina one switch away, guided install

What it does

Plays inside Mac Steam Windows games sit in your Mac Steam library and start with Play. They run in Wine under Rosetta 2.
DirectX 12 on Metal Apple's D3DMetal runs DirectX 11 and 12 on your Mac's GPU.
DLSS, answered by MetalFX Games on D3DMetal see an NVIDIA card by default, so DLSS shows up. Apple's toolkit runs it on MetalFX.
Frame generation (experimental) Up to 3× displayed frames, with a little added latency. Off by default; turn it on per game.
Any controller DualSense, Xbox, GameSir and more, with no mapping screen.
Full Retina, one switch away Off by default because it's slower. Turn on High Resolution to draw at your display's real resolution.
Guided install A Setup Assistant walks you through Rosetta, Steam and permissions.

Mac gaming, unleashed: 007 First Light running on Direct3D 12 through D3DMetal, with the Metal HUD at 90 fps

Illustrations of the real screens.

Already playing

Games running with Bridgeplay: Resident Evil Requiem, Marvel's Spider-Man 2, 007 First Light and more

Developer's tests on an M5 Max MacBook Pro with Game Porting Toolkit 4.0 beta 3: 90+ fps, with MetalFX upscaling and frame generation where listed. Settings come from each game's launch log.

Game Launch settings
Resident Evil Requiem D3DMetal · DLSS → MetalFX · DLSS Frame Gen (experimental) · Retina · V-Sync forced
Marvel's Spider-Man 2 D3DMetal · Retina · MSync
007 First Light D3DMetal · DLSS → MetalFX · DLSS Frame Gen (experimental) · Retina

Also running on the same setup: Mortal Kombat 1, The Last of Us Part I, Death Stranding Director's Cut, Horizon Zero Dawn, Split Fiction, It Takes Two, A Way Out, Batman: Arkham Knight, Sifu, Ghostrunner, Ravenswatch, Megabonk, PowerWash Simulator 2, The Witcher 3.

Most games with kernel-level anti-cheat won't run.

Compatibility list

Every game tested so far, and the Mac it ran on, is at bridgeplay.dev/compatibility. It combines results a maintainer checked (compat/), one-tap reports from players, and CrossOver ratings from AppleGamingWiki for games nobody has tried with Bridgeplay yet.

To add yours: after you play, Bridgeplay asks once per game How did it run? One tap posts the result, with your Mac and the game's log, to Compatibility reports. No GitHub account needed, and the log is stripped of your user, computer and Steam account details. Report Your Games… in the Prefix menu covers everything you've already played, and bridgeplay.dev/privacy lists what a report contains. Without the app, use the Game report form.

Install

  1. Download Bridgeplay from bridgeplay.dev: Bridgeplay.dmg, notarized by Apple.
  2. Drag Bridgeplay into Applications and open it. macOS asks once whether to open an app downloaded from the internet: click Open. It needs an admin account.
  3. Follow the Setup Assistant: Rosetta, Apple's graphics (Download fetches them, and Steam from Valve if it's missing), Steam sign-in, App Management and a couple of other standard macOS prompts. Every download is verified: Bridgeplay's signature or pinned hashes for its own files and the engine, Apple's signature for the toolkit's files, Valve's for Steam. Setup modifies your Steam app; see What Bridgeplay changes in Steam.
  4. Press Play on any Windows game in Steam. The first time you use a controller, allow Steam's Input Monitoring request.

Each game's Bridgeplay settings (graphics backend, performance overlay, frame rate limit, scaling filter, DLSS, frame generation, controllers) are in Steam: right-click the game, Properties… › Bridgeplay.

Updates install themselves: Bridgeplay, its patch in Steam and the engine. Refresh on the Status page checks on demand.

The Setup Assistant's graphics download carries Apple's Game Porting Toolkit redistributables, unmodified, under Apple's own license; docs/GPTK-LICENSE.md records how Bridgeplay handles it. You can use your own copy from Apple instead. Bridgeplay is free and non-commercial.

The Setup Assistant working through Your Mac, Rosetta, Graphics, Steam and Set Up

Requirements

Check your Mac in one click on bridgeplay.dev, next to the minimum requirements

Mac Apple Silicon, M1 or later. Intel Macs are not supported.
macOS 26 or later (macOS version guide)
Steam A Steam account. Windows games install from Steam as usual.
Download About 550 MB: a 19 MB disk image, then about 530 MB, most of it the engine, that the Setup Assistant fetches. Installing Rosetta 2 and Steam, and signing in to Steam, need internet.

Guides and help

The guides on bridgeplay.dev cover installing Bridgeplay, troubleshooting, DirectX 12, DLSS and frame generation, and anti-cheat. The FAQ answers common questions, and the compatibility list shows which games other players got running.

How it works

Bridgeplay runs inside the native macOS Steam client and registers itself as a Steam Play compatibility tool. Under the hood:

How a Windows game reaches the Mac's GPU: Steam, Bridgeplay, the WineCX and Wine engines, D3DMetal, DXMT, DXVK and MoltenVK, then Metal, with the open-source project behind each piece

Building from source: see docs/DEVELOPING.md, docs/ARCHITECTURE.md and docs/BUILD-LOCAL.md. The graphics download (Bridgeplay-Installer.zip) is built from installer/ by scripts/package-installer.sh.

What Bridgeplay changes in Steam

Bridgeplay modifies your Steam app. It copies a library (notproton.dylib) into /Applications/Steam.app, makes Steam load it at startup through Info.plist, and re-signs Steam on your Mac, replacing Valve's signature. The library hooks Steam's compatibility tool, shortcut and launch option code, and edits Steam's interface in memory to show Steam Play.

Also changed:

Valve doesn't support or endorse Bridgeplay, and modifying Steam may go against the Steam Subscriber Agreement. Use it at your own risk. Repair Steam or Remove Everything on the Status page restores Steam's Info.plist; if Valve's signature isn't back, reinstall Steam from Valve.

Online games and anti-cheat

Online games with anti-cheat (Easy Anti-Cheat, BattlEye and others) often won't start, and Bridgeplay can't promise that anti-cheat, VAC included, won't flag it. Counter-Strike 2 and Dota 2 run, but VAC keeps them off its secure servers. Play online at your own risk. The compatibility list shows what other players found.

Credits

Bridgeplay is a fork of NotProton by NotProtonNot and its contributors (GPL-3.0), by way of Leon Seemann's NotProton-WineHQ. The Steam hooks, the Steam Play interface patches, the run script and the steamclient bridge all started as their work. Copyright and license details are in NOTICE.

NotProton in turn thanks the people who came before it, among them Nat Brown's Kaon, mont127's Neutron and Gio's work on Steam Play in Mac Steam; see docs/UPSTREAM.md.

Support Wine

Wine on the Mac exists largely because of CodeWeavers, the biggest contributor to the Wine project. They fund that work by selling CrossOver. Bridgeplay's free engine comes from the WineCX code CodeWeavers publishes, so every game it runs also stands on their work.

If you can, buy CrossOver.

License

Bridgeplay is licensed under the GPL-3.0. Third-party licenses, and the source for the patched Wine files the app ships (LGPL-2.1-or-later), are listed in NOTICE.

 Built by Raymond Chin, Jakarta.

Bridgeplay is built on NotProton and is not affiliated with or endorsed by Apple, Valve, Microsoft, NVIDIA, Sony, CodeWeavers or any game publisher. Steam is a trademark of Valve Corporation; Mac, macOS, Metal, MetalFX and Rosetta of Apple Inc.; Windows, DirectX and Xbox of Microsoft; CrossOver of CodeWeavers; DLSS and GeForce of NVIDIA; DualSense of Sony Interactive Entertainment. Game names, game art and other product names belong to their owners and are used only to identify them.

Bridgeplay (raymondchins/Bridgeplay)

Ищем в базе…

Что это такое?Bridgeplay позволяет запускать игры для Windows из Steam на Mac с процессором Apple Silicon прямо в приложении Steam для macOS. Для этого используются Wine от CodeWeavers и Game Porting Toolkit от Apple, поэтому игры запускаются той же кнопкой Play, что и нативные игры.
Это отдельный лаунчер или работает внутри Steam?Это установщик для macOS, который дорабатывает ваш Steam.app и регистрирует его как инструмент совместимости Steam Play. Второго лаунчера нет: вы просто нажимаете Play у игры для Windows в обычной библиотеке Steam.
Как это запустить?Скачайте Bridgeplay-Setup.zip с сайта bridgeplay.dev и откройте его (потребуется разрешить запуск в обход Gatekeeper macOS). Затем пройдите Setup Assistant: установка Rosetta, вход в Steam и подтверждение разрешений. После этого нажатие Play у любой игры для Windows в Steam будет запускать её через Bridgeplay.
Что нужно перед установкой?Mac с процессором Apple Silicon (M1 или новее) на macOS 26 или новее, аккаунт Steam, учётная запись администратора для установки, а также около 570 МБ загрузок и доступ в интернет для Rosetta 2 и Steam.
Будут ли работать все мои игры в Steam?Большинство игр с античитом на уровне ядра (Easy Anti-Cheat, BattlEye и похожие) вообще не запустятся. Игры с защитой VAC, например Counter-Strike 2 и Dota 2, запускаются, но их не пускают на защищённые серверы, поэтому игра онлайн на ваш страх и риск.
Отправляются ли мои данные куда-то, когда я сообщаю о совместимости игры?Да, отчёт «How did it run?» одним нажатием отправляет модель вашего Mac и лог запуска игры в общую базу совместимости. Перед отправкой из лога удаляются имя пользователя, имя компьютера и данные аккаунта Steam.
Что именно Bridgeplay меняет на моём Mac при установке?Он копирует библиотеку в Steam.app, настраивает Steam на её загрузку при старте, переподписывает Steam (подпись Valve заменяется), сбрасывает некоторые разрешения macOS и назначает себя инструментом совместимости Steam Play по умолчанию. На странице Status есть пункт Repair Steam, который может вернуть исходный Info.plist Steam.
Bridgeplay — это то же самое, что NotProton?Нет. Bridgeplay — это свободный форк NotProton (который, в свою очередь, основан на NotProton-WineHQ). Он использует те же хуки Steam и патчи интерфейса Steam Play, а работа оригинального автора продолжается отдельно.
Как работает DLSS, если в Mac нет видеокарт NVIDIA?Игры на D3DMetal от Apple по умолчанию видят поддельную видеокарту NVIDIA GeForce RTX 4090, поэтому у них появляется опция DLSS. Масштабирование выполняет MetalFX от Apple, а не реальное оборудование NVIDIA.
Можно ли использовать мою лицензию CrossOver вместо встроенного бесплатного движка?Да, если CrossOver у вас уже куплен, Bridgeplay может запускать игры через него вместо собственного бесплатного движка WineCX. Тот собран из опубликованного CodeWeavers исходного кода под лицензией LGPL.
Какие есть похожие проекты?highball, recall, NotProton, DLSS5-Autopilot, LostOdysseyRecomp, 1-Click-DLSS5, S2Arm, omakade
Автор
raymondchins
Размер
91.5 MB
Звёзды
1K
Возраст
29 д
Коммиты · 90 дней