Skip to content

Free fork of NotProton: Windows Steam games in Mac Steam, on CodeWeavers' Wine and Apple's Game Porting Toolkit

docs: rename NotProton paths, tools, logs and env vars to Bridgeplay

raymondchinsfdd3ed597043
diff --git a/NOTICE b/NOTICE
index aa8b617..fd36bcb 100644
--- a/NOTICE
+++ b/NOTICE
@@ -57,7 +57,7 @@ sha256 pins are in docs/WINECX.md and each patch directory's README.
Wine 11.15 (WineHQ release tarball):
winemac-winehq-11.15.so winemac-patch/dxmt_export.c
-All files above are in app/Sources/NotProtonApp/Resources/. The engine's ntdll
+All files above are in app/Sources/BridgeplayApp/Resources/. The engine's ntdll
is patched at setup with detours built from ntdll-patch/ (detour*.bin in the
same folder). nvapi64-shim.dll is Bridgeplay's own code, built from nvapi-shim/.
@@ -102,7 +102,7 @@ MIT licensed, see
https://github.com/sparkle-project/Sparkle/blob/2.10.0/LICENSE
The app's interface uses the Geist and Unbounded typefaces, bundled in
-app/Sources/NotProtonApp/Resources/Fonts/ under the SIL Open Font License 1.1
+app/Sources/BridgeplayApp/Resources/Fonts/ under the SIL Open Font License 1.1
(OFL-Geist.txt, OFL-Unbounded.txt there). Game covers shown in the app are read
from the user's own Steam library cache or Steam's CDN at run time; none ship
with Bridgeplay.
@@ -122,12 +122,12 @@ These third party files carry their original notices from the project authors:
The WineCX engine gets an x86_64 SDL2 from the app bundle, for controller support
in winebus.so (docs/WINECX.md):
- app/Sources/NotProtonApp/Resources/libSDL2-2.0.0.dylib
+ app/Sources/BridgeplayApp/Resources/libSDL2-2.0.0.dylib
Simple DirectMedia Layer 2.32.10 (SDL-release-2.32.10-0-g5d2495703),
https://github.com/libsdl-org/SDL/tree/release-2.32.10, built x86_64 with
winemac-patch/sdl2-iokit-gamepad-collection.patch and signed ad hoc.
Copyright (C) 1997-2025 Sam Lantinga <[email protected]>.
zlib license, https://github.com/libsdl-org/SDL/blob/release-2.32.10/LICENSE.txt
- app/Sources/NotProtonApp/Resources/winebus-winecx-11.15.so
+ app/Sources/BridgeplayApp/Resources/winebus-winecx-11.15.so
winecx 5b45f45 (Wine, LGPL-2.1-or-later), built with SDL2 support.
diff --git a/docs/BUILD-LOCAL.md b/docs/BUILD-LOCAL.md
index 9daee8b..3031c0d 100644
--- a/docs/BUILD-LOCAL.md
+++ b/docs/BUILD-LOCAL.md
@@ -29,9 +29,9 @@ output to `build/logs/<phase>.log`.
| Path | What |
|---|---|
-| `build/NotProton.app` | ad-hoc signed app, passes `codesign --verify --strict` |
-| `build/NotProton.zip` | `ditto -c -k --keepParent` of the app, as CI packages it |
-| `out/NotProton.app` | the bundle `make app` writes; the script copies it to `build/` |
+| `build/Bridgeplay.app` | ad-hoc signed app, passes `codesign --verify --strict` |
+| `build/Bridgeplay.zip` | `ditto -c -k --keepParent` of the app, as CI packages it |
+| `out/Bridgeplay.app` | the bundle `make app` writes; the script copies it to `build/` |
At the end the script prints the version (from `dylib/version.h`: `make app` writes
`BRIDGEPLAY_VERSION` into `CFBundleShortVersionString` and `BRIDGEPLAY_BUILD` into
diff --git a/docs/DEVELOPING.md b/docs/DEVELOPING.md
index d105ec8..bc6eb64 100644
--- a/docs/DEVELOPING.md
+++ b/docs/DEVELOPING.md
@@ -25,7 +25,9 @@
---
-## NotProton
+## NotProton (upstream)
+
+_From upstream's README._
NotProton enables the Steam Play experience from Linux Steam in the macOS Steam client.
@@ -50,9 +52,9 @@ If a game has a native macOS version as well as a Windows one, Steam will downlo
## Free Wine engine (no CrossOver needed)
-NotProton can also run entirely on free software. Under Compatibility Tool, **Download & Set Up**
+Bridgeplay can also run entirely on free software. Under Compatibility Tool, **Download & Set Up**
fetches the WineHQ 11.15 macOS build from [Gcenx/macOS_Wine_builds](https://github.com/Gcenx/macOS_Wine_builds)
-(hash pinned), unpacks it into `~/Library/Application Support/notproton/engines/` and sets the
+(hash pinned), unpacks it into `~/Library/Application Support/bridgeplay/engines/` and sets the
compatibility tool up from it exactly like a CrossOver copy. No CrossOver license is involved; the
license check is skipped only for loaders whose hash pins the free build.
@@ -65,7 +67,7 @@ against. Differences from CrossOver to be aware of:
Wine's own wined3d cannot reach feature level 11 on macOS OpenGL. D3DMetal is Apple's and needs
CrossOver's Wine changes, so this engine does not use it; the WineCX engine can, with a Game
Porting Toolkit you supply (`docs/WINECX.md`).
-- DXMT needs macdrv functions upstream Wine hides; NotProton ships a rebuilt `winemac.so`
+- DXMT needs macdrv functions upstream Wine hides; Bridgeplay ships a rebuilt `winemac.so`
that exports them (see `winemac-patch/`).
- D3D 12 has no fast path; vkd3d over the bundled MoltenVK is limited.
- WineHQ has no msync/esync, so CPU-heavy games can run slower than under CrossOver or Sikarugir.
@@ -96,5 +98,5 @@ Developer Notes:
As far as the source structure goes, the macOS app itself is located in the ```app``` folder. The core logic is in ```dylib```.
```lsteamclient``` is a macOS port of Valve's lsteamclient. ```steam-shim```is a port of Valve's
steam-helper from Proton 9.0. ntdll-patch patches the copy of CrossOver that the app
-makes/places in the ```~/Library/Application Support/notproton/runners/``` folder so that
+makes/places in the ```~/Library/Application Support/bridgeplay/runners/``` folder so that
lsteamclient is loaded.
diff --git a/docs/DXMT.md b/docs/DXMT.md
index 15bd2c6..50b0e8a 100644
--- a/docs/DXMT.md
+++ b/docs/DXMT.md
@@ -1,6 +1,6 @@
# DXMT build
-NotProton ships DXMT built from a pinned master commit, not the v0.80 release, to pick up
+Bridgeplay ships DXMT built from a pinned master commit, not the v0.80 release, to pick up
the 262 commits since that release (D3D11 fixes, the macOS 27 HUD fix, Xcode 27 build
fixes, the WIP D3D12 backend).
@@ -11,7 +11,7 @@ fixes, the WIP D3D12 backend).
| Tarball | `dxmt-e94c312.tar.gz`, top-level directory `e94c312/` |
| License | LGPL-2.1-or-later since `ec357fd` (v0.80 was the last MIT release) |
-## In NotProton
+## In Bridgeplay
Both free engines download this tarball from
`https://github.com/raymondchins/Bridgeplay/releases/download/dxmt-e94c312/` into the
diff --git a/docs/GAMEFIXES.md b/docs/GAMEFIXES.md
index 5e8831e..6cdc14c 100644
--- a/docs/GAMEFIXES.md
+++ b/docs/GAMEFIXES.md
@@ -2,12 +2,15 @@
The `run` script reads two optional files for each game, named after its Steam app id:
-1. `~/Library/Application Support/notproton/gamefixes-default/<appid>.conf`, shipped with NotProton
-2. `~/Library/Application Support/notproton/gamefixes/<appid>.conf`, your own
+1. `~/Library/Application Support/bridgeplay/gamefixes-default/<appid>.conf`, shipped with Bridgeplay
+2. `~/Library/Application Support/bridgeplay/gamefixes/<appid>.conf`, your own
The later file wins per key. A variable you set in the game's Steam launch options
(`NAME=value %command%`) wins over both files.
+Bridgeplay's own variables are spelled `BRIDGEPLAY_*` (`BRIDGEPLAY_RETINA=1`). The
+`NOTPROTON_*` spelling from before 3.0.0 still works, in launch options and in conf files.
+
## Format
One `KEY=VALUE` per line. Blank lines and lines starting with `#` are ignored, and so is
@@ -25,12 +28,12 @@ logged, when:
| `ARGS` | space-separated arguments of `A-Za-z0-9_+./:=,-` | Added to the game's command line after the launch options' own arguments. Ignored for installers and other helpers |
| `DLLOVERRIDES` | Wine syntax, e.g. `dinput8=n,b;xinput1_3=n` | Added to `WINEDLLOVERRIDES` after the backend's entries and before the launch options' |
| `MSYNC` | `0`, `1` | `1` turns msync on when the engine supports it; `0` turns it off |
-| `RETINA` | `0`, `1` | Same as `NOTPROTON_RETINA` (High Resolution) |
-| `FRAMEGEN` | `0`, `1`, `2`, `3`, `adaptive` | Same as `NOTPROTON_FRAMEGEN`: experimental frame generation in overlay-shim, adds up to half a frame of latency. `2` and `3` multiply the frame rate, `adaptive` fills up to the display refresh, `1` is the same as `2`, `0` is off (the default) |
-| `FRAMEGEN_QUALITY` | `performance`, `balanced`, `quality` | Same as `NOTPROTON_FRAMEGEN_QUALITY`. `balanced` when unset |
-| `FRAMEGEN_UI` | `0`, `1` | Same as `NOTPROTON_FRAMEGEN_UI`, Protect UI: keeps static HUD and menus sharp. On when unset |
-| `FRAMEGEN_FALLBACK` | `0`, `1` | Same as `NOTPROTON_FRAMEGEN_FALLBACK`, Fast-motion fallback: skips generated frames that would smear. On when unset |
-| `FRAMEGEN_ENGINE` | `own`, `metalfx` | Same as `NOTPROTON_FRAMEGEN_ENGINE`: the built-in optical flow (`own`, the default) or MetalFX frame interpolation |
+| `RETINA` | `0`, `1` | Same as `BRIDGEPLAY_RETINA` (High Resolution) |
+| `FRAMEGEN` | `0`, `1`, `2`, `3`, `adaptive` | Same as `BRIDGEPLAY_FRAMEGEN`: experimental frame generation in overlay-shim, adds up to half a frame of latency. `2` and `3` multiply the frame rate, `adaptive` fills up to the display refresh, `1` is the same as `2`, `0` is off (the default) |
+| `FRAMEGEN_QUALITY` | `performance`, `balanced`, `quality` | Same as `BRIDGEPLAY_FRAMEGEN_QUALITY`. `balanced` when unset |
+| `FRAMEGEN_UI` | `0`, `1` | Same as `BRIDGEPLAY_FRAMEGEN_UI`, Protect UI: keeps static HUD and menus sharp. On when unset |
+| `FRAMEGEN_FALLBACK` | `0`, `1` | Same as `BRIDGEPLAY_FRAMEGEN_FALLBACK`, Fast-motion fallback: skips generated frames that would smear. On when unset |
+| `FRAMEGEN_ENGINE` | `own`, `metalfx` | Same as `BRIDGEPLAY_FRAMEGEN_ENGINE`: the built-in optical flow (`own`, the default) or MetalFX frame interpolation |
| `NVAPI` | `0`, `1` | `1` turns on Apple's `nvapi64` and `nvngx` (DLSS on MetalFX) on an engine with a linked Game Porting Toolkit, for `d3dmetal` only, and makes D3DMetal report an NVIDIA GeForce RTX 4090 (`D3DM_VENDOR_ID=0x10de`, `D3DM_DEVICE_ID=0x2684`, `D3DM_DEVICE_DESCRIPTION`; a `D3DM_*` from a conf or the launch options wins), since games offer DLSS only on an NVIDIA adapter. Off by default, since an nvapi that answers sends some games down NVIDIA-only paths |
| `DLSS_FG` | `0`, `1` | With `NVAPI=1` on `d3dmetal`, `1` sets `CX_ACTIVE_GRAPHICS_BACKEND=d3dmetal` so WineCX reports hardware GPU scheduling, which DLSS frame generation requires. Off by default: [frankea/Whisky#231](https://github.com/frankea/Whisky/pull/231) saw MetalFX frame interpolation on an M5 with D3DMetal 4.0b2 hang WindowServer |
| `STDOUT_NULL` | `0`, `1` | `1` starts the game without a stdout handle, as Steam on Windows does. Source 2 treats any stdout as a console build (`Plat_IsConsoleApplication`) and then skips NGX, so Deadlock offers no DLSS |
@@ -52,7 +55,7 @@ Wine uses the last entry for a DLL in `WINEDLLOVERRIDES`. The order is: backend,
The backend is picked in this order:
-1. `NOTPROTON_BACKEND=<name>` in the launch options
+1. `BRIDGEPLAY_BACKEND=<name>` (or `NOTPROTON_BACKEND`) in the launch options
2. `CX_GRAPHICS_BACKEND` in the launch options, which the Steam panel's Graphics menu sets.
Any case is accepted. `d3dmetal`, `dxmt` and `dxvk` map to themselves, and `wined3d`,
`opengl` and `wine` map to `wined3d`. Other values are logged and ignored
@@ -96,7 +99,7 @@ Every other DLL that any backend ships is set to `b`. When you switch backends,
left behind by another backend is replaced with Wine's own (the set-aside copy on an
engine with D3DMetal; Apple's files are never copied into a prefix). `d3dmetal` also sets
`CX_GRAPHICS_BACKEND=d3dmetal`. The run log
-(`notproton-run.log`) shows each decision. The `notproton-backend` file in the game's
+(`bridgeplay-run.log`) shows each decision. The `notproton-backend` file in the game's
compatdata folder has the current backend and why it was picked.
## Examples
@@ -140,15 +143,15 @@ RETINA=1
## Native macOS games
-A Mac build with no compatibility tool pinned runs through `~/.notproton/np-native`, not the
+A Mac build with no compatibility tool pinned runs through `~/.bridgeplay/np-native`, not the
`run` script, so the files above do not apply to it. np-native reads its own two files,
-with variable names as they are (`NOTPROTON_FRAMEGEN=2`, `NP_PAD_MODE=hid`, `MTL_HUD_ENABLED=1`):
+with variable names as they are (`BRIDGEPLAY_FRAMEGEN=2`, `NP_PAD_MODE=hid`, `MTL_HUD_ENABLED=1`):
-1. `~/Library/Application Support/notproton/gamefixes/native-default.conf`, for every native game
-2. `~/Library/Application Support/notproton/gamefixes/native/<appid>.conf`, which wins per key
+1. `~/Library/Application Support/bridgeplay/gamefixes/native-default.conf`, for every native game
+2. `~/Library/Application Support/bridgeplay/gamefixes/native/<appid>.conf`, which wins per key
The Steam panel for such a game shows the Metal HUD, Frame Generation and the controller
layer (`NP_PAD_MODE`: `hid`, `gc` or `off`). It writes the launch options as
-`<home>/.notproton/np-native VAR=VALUE ... %command% <game args>`, and rewrites the older
+`<home>/.bridgeplay/np-native VAR=VALUE ... %command% <game args>`, and rewrites the older
`/usr/bin/arch -arm64 -x86_64 -e VAR=VALUE ... %command%` form into that one, dropping its
`DYLD_INSERT_LIBRARIES`.
diff --git a/docs/RELEASING.md b/docs/RELEASING.md
index 3cdee6d..e4c1a9b 100644
--- a/docs/RELEASING.md
+++ b/docs/RELEASING.md
@@ -78,3 +78,27 @@ archive, and never check on their own (`SUEnableAutomaticChecks` was false).
the same app zipped as `NotProton.app`. Those users get it from Check for Updates…; it
installs over `/Applications/NotProton.app`, and later updates come from the Bridgeplay
feed, matched by bundle identifier.
+
+## The 3.0.0 rename
+
+3.0.0 renames everything on disk from `notproton` to `bridgeplay`:
+
+| Before | From 3.0.0 |
+|---|---|
+| `~/Library/Application Support/notproton` | `~/Library/Application Support/bridgeplay` |
+| `~/Library/Caches/notproton` | `~/Library/Caches/bridgeplay` |
+| `~/.notproton` (np-native, libnp_gamepad.dylib) | `~/.bridgeplay` |
+| Steam tools `notproton-winecx-11.17`, `notproton-winehq`, … | `bridgeplay-winecx-11.17`, `bridgeplay-winehq`, … |
+| `notproton-run.log`, `notproton-wine.log`, `notproton.log` | `bridgeplay-run.log`, `bridgeplay-wine.log`, `bridgeplay.log` |
+| `NOTPROTON_*` in launch options and conf files | `BRIDGEPLAY_*` (the old spelling still works) |
+
+Unchanged: `notproton.dylib`, `lib/notproton-backends`, the prefix markers in `compatdata`
+(`notproton-build`, `notproton-backend`), the launcher bundle ids
+`com.notproton.launcher.<appid>` and the `NOTPROTON_VERSION` define.
+
+The app migrates on its first launch after the update, once Steam and every game are
+closed: it moves the folders and switches games mapped to a `notproton*` tool to its
+`bridgeplay*` name. What it replaces is backed up under
+`~/Library/Application Support/bridgeplay/backups/migration-3.0.0/`. Nothing is needed in the
+release steps; `scripts/release-local.sh` and `scripts/package-installer.sh` fall back to the
+`notproton` folders on a Mac that has not migrated yet.
diff --git a/docs/STATE.md b/docs/STATE.md
index 10e566b..bdd9162 100644
--- a/docs/STATE.md
+++ b/docs/STATE.md
@@ -6,15 +6,15 @@ Branch `integrate` = working fork state; nothing pushed except the `dxmt-e94c312
- 14+ Windows-only games reach a full-screen window; Spider-Man 2 plays (77.9 fps, loads save). See compat/games.json.
- Retina: D3DMetal back buffers sized in pixels (winemac patch, 233353d).
- Xbox controllers: SDL-enabled winebus (9a0cbf5). Do NOT set winebus `Hidraw=1` for pads; it bypasses SDL.
-- Controllers need no per-game Input Monitoring grant: the run script starts the launcher bundle directly instead of via `open`, so TCC attributes HID access to Steam (verified: all `kTCCServiceListenEvent` requests from Horizon `responsible=com.valvesoftware.steam`, authValue=2). `NOTPROTON_LAUNCH_SERVICES=1` restores the old `open` launch.
-- Pads SDL doesn't know: `~/Library/Application Support/notproton/gamecontrollerdb.txt` is exported as `SDL_GAMECONTROLLERCONFIG`. GameSir G7 Pro dongle (3537:1022) mapping lives there; SDL IOKit axis order is X,Y,Z,Rz,Accel,Brake (browser Gamepad API numbers them differently). Never use the winebus registry `map` key: its loader (main.c:1101, writes `mappings[count]` after `count++`) crashes winebus and kills every pad.
+- Controllers need no per-game Input Monitoring grant: the run script starts the launcher bundle directly instead of via `open`, so TCC attributes HID access to Steam (verified: all `kTCCServiceListenEvent` requests from Horizon `responsible=com.valvesoftware.steam`, authValue=2). `BRIDGEPLAY_LAUNCH_SERVICES=1` (or `NOTPROTON_LAUNCH_SERVICES=1`) restores the old `open` launch.
+- Pads SDL doesn't know: `~/Library/Application Support/bridgeplay/gamecontrollerdb.txt` is exported as `SDL_GAMECONTROLLERCONFIG`. GameSir G7 Pro dongle (3537:1022) mapping lives there; SDL IOKit axis order is X,Y,Z,Rz,Accel,Brake (browser Gamepad API numbers them differently). Never use the winebus registry `map` key: its loader (main.c:1101, writes `mappings[count]` after `count++`) crashes winebus and kills every pad.
- Bluetooth GameSir G7 Pro: its primary HID usage is Consumer, so stock SDL skips it; bundled libSDL2 carries winemac-patch/sdl2-iokit-gamepad-collection.patch, and the run script exports SDL_JOYSTICK_MFI=0 (SDL's MFi driver claims the pad but finds nothing in winedevice.exe). Verified 2026-10-11: winebus `sdl_add_device … is_gamepad 1`, user confirmed input in Megabonk.
- Many games need `ROSETTA_ADVERTISE_AVX=1` (set in user gamefixes/default.conf and per-game Steam launch options).
## Blockers / open
-- NotProton can't deploy to Steam: App Management permission is lost on every ad-hoc rebuild (`run failed: cannot write /Applications/Steam.app/Contents/MacOS`). User must re-allow NotProton in Privacy & Security > App Management. Long-term: sign builds with a stable identity.
+- Bridgeplay can't deploy to Steam: App Management permission is lost on every ad-hoc rebuild (`run failed: cannot write /Applications/Steam.app/Contents/MacOS`). User must re-allow Bridgeplay in Privacy & Security > App Management. Long-term: sign builds with a stable identity.
- Ravenswatch: fixed by winemac 76d8f938… (CW HACK 22435 in winecx-d3dmetal-retina.patch: queue D3DMetal client view frames before WM_SIZE so ResizeBuffers sees the borderless size; 3024x1964 confirmed by user via Metal HUD 2026-10-10).
- Borderlands 4: hangs before first frame (exception storm, likely Denuvo under Rosetta). Not solved.
- The Last of Us Part I: not crashing; probably long first shader build. Skipped by user.
- DOOM: The Dark Ages / Indiana Jones need hardware ray tracing (MoltenVK has none); Half-Life: Alyx is VR.
-- Native macOS games (2026-10-11): stay native (no CompatToolMapping, no `userdata/*/config/compat.vdf` platform_overrides). Steam on macOS execs launch options literally, so `VAR=1 %command%` fails with OS Error 260; use `/usr/bin/arch -arm64 -x86_64 -e VAR=1 %command% <flags>` (also stops Rosetta inheritance from the x86_64 Steam client). Bluetooth GameSir G7 Pro in native Unity games: `native-shim/gamepad_shim.c` (DYLD_INSERT_LIBRARIES, built to `~/.notproton/libnp_gamepad.dylib`) presents it as an Xbox Wireless Controller and rewrites report 7 to the Xbox BT layout; verified in Chained Beasts Demo (arm64, controller works).
+- Native macOS games (2026-10-11): stay native (no CompatToolMapping, no `userdata/*/config/compat.vdf` platform_overrides). Steam on macOS execs launch options literally, so `VAR=1 %command%` fails with OS Error 260; use `/usr/bin/arch -arm64 -x86_64 -e VAR=1 %command% <flags>` (also stops Rosetta inheritance from the x86_64 Steam client). Bluetooth GameSir G7 Pro in native Unity games: `native-shim/gamepad_shim.c` (DYLD_INSERT_LIBRARIES, built to `~/.bridgeplay/libnp_gamepad.dylib`) presents it as an Xbox Wireless Controller and rewrites report 7 to the Xbox BT layout; verified in Chained Beasts Demo (arm64, controller works).
diff --git a/docs/WINECX.md b/docs/WINECX.md
index 6404c9d..c279239 100644
--- a/docs/WINECX.md
+++ b/docs/WINECX.md
@@ -1,6 +1,6 @@
# WineCX engine
-NotProton's second free engine. WineCX is CodeWeavers' open-source (LGPL) CrossOver 26.3
+Bridgeplay's second free engine. WineCX is CodeWeavers' open-source (LGPL) CrossOver 26.3
Wine changes, rebased by dappermint onto upstream Wine
([dappermint/winecx](https://github.com/dappermint/winecx)). It is built in CI into a Whisky
runtime by [dappermint/winecx-gptk](https://github.com/dappermint/winecx-gptk).
@@ -9,15 +9,15 @@ Two releases are pinned side by side (`FreeEngineWinecx.releases`):
| Build | Runtime | winecx | Wine | Tool | Bundle |
|---|---|---|---|---|---|
-| `winecx-11.17` (current) | 4.7.3 | `e0aa380` | 11.17 | `notproton-winecx-11.17` | `WineCX 11.17.app` |
-| `winecx-11.15` | 4.5.125 | `5b45f45` | 11.15 | `notproton-winecx` | `WineCX 11.15.app` |
+| `winecx-11.17` (current) | 4.7.3 | `e0aa380` | 11.17 | `bridgeplay-winecx-11.17` | `WineCX 11.17.app` |
+| `winecx-11.15` | 4.5.125 | `5b45f45` | 11.15 | `bridgeplay-winecx` | `WineCX 11.15.app` |
The WineCX row installs the current one. Each release is its own runner build with its own
-pins, ntdll detours and Steam tool. `notproton-winecx` stays on 11.15: every existing prefix's
+pins, ntdll detours and Steam tool. `bridgeplay-winecx` stays on 11.15: every existing prefix's
build record (`notproton-build`) names `winecx-11.15`, and `refuse_other_build` in
`compat_run.sh` refuses a prefix claimed by another build, so moving the default tool would
stop every WineCX game until its prefix is rebuilt. 11.17 is picked per game as "WineCX 11.17"
-(`notproton-winecx-11.17`), on a rebuilt prefix.
+(`bridgeplay-winecx-11.17`), on a rebuilt prefix.
4.7.3 over 4.5.125: msync fixes (wake one waiter, skip wake syscalls nobody waits on, sleep
instead of spinning while a wait registers, unregister on contention), kernelbase
@@ -31,12 +31,12 @@ Compared with the WineHQ 11.15 engine it adds:
round trips that slow down CPU-heavy games.
- **D3DMetal support** through CrossOver's hooks (winemac `macdrv_functions`, the
`libd3dshared` non-native code regions in ntdll, and the d3dkmt answers). This only works
- with a Game Porting Toolkit you install yourself. NotProton never downloads or ships it.
+ with a Game Porting Toolkit you install yourself. Bridgeplay never downloads or ships it.
- **DXMT master and DXVK-macOS 1.10.3** as backends a game opts into. DXMT is the same
`e94c312` build as the WineHQ engine ([DXMT.md](DXMT.md)), not the archive's 0.80. The
builtin Direct3D is Wine's own, or D3DMetal once a Game Porting Toolkit is linked.
-In NotProton the current build is `winecx-11.17`, tool `notproton-winecx-11.17`, shown as
+In Bridgeplay the current build is `winecx-11.17`, tool `bridgeplay-winecx-11.17`, shown as
"WineCX 11.17 (msync, D3DMetal)". Like the WineHQ engine it needs no CrossOver license. The licence check
treats it as free only because the loader hash matches the pinned one, so a CrossOver install
can never pass as it.
@@ -80,10 +80,10 @@ waiting on.
Layout inside the archive: `Libraries/Wine` is the Wine tree (`bin/`, `lib/wine/{x86_64-unix,
x86_64-windows,i386-windows}`, bundled dylibs in `lib/`, `share/wine` with wine-mono 11.2.0
and gecko). `Libraries/DXMT/{x64,x32}` holds DXMT 0.80's frontends with the builtin marker
-stripped, which NotProton does not use. `Libraries/DXVK/{x64,x32}` holds DXVK. A 0.80-era
-`winemetal` is a builtin in `lib/wine`, which NotProton replaces.
+stripped, which Bridgeplay does not use. `Libraries/DXVK/{x64,x32}` holds DXVK. A 0.80-era
+`winemetal` is a builtin in `lib/wine`, which Bridgeplay replaces.
-## What NotProton lays out
+## What Bridgeplay lays out
The engine root (`…/WineCX 11.17.app/Contents/SharedSupport/CrossOver`, cloned into the runner
`runners/crossover-winecx-11.17`; likewise for 11.15) is the archive's `Libraries/Wine`, plus:
@@ -119,7 +119,7 @@ The engine's `winemac.so` is still replaced, for D3DMetal: winecx's own let D3DM
swapchain from its view's frame in points, so with High Resolution (Retina) on, a game got a
half-size drawable and showed only the top-left quarter, and a `ResizeBuffers` from
`WM_SIZE` read the view's frame before it had followed the window, so the swapchain kept
-its old size (Ravenswatch: 3024x1752 stretched over a 3024x1964 screen). NotProton installs
+its old size (Ravenswatch: 3024x1752 stretched over a 3024x1964 screen). Bridgeplay installs
`winemac-winecx-<build>.so`, built from winecx `e0aa380` with
`winemac-patch/winecx-11.17-d3dmetal-retina.patch` (11.17) or from `5b45f45` with
`winemac-patch/winecx-d3dmetal-retina.patch` (11.15), see `winemac-patch/README.md`, pinned as
@@ -133,7 +133,7 @@ macOS 26 SDK lacks. A gamepad then had no path into Wine: winebus ignores the IO
HID device for a gamepad unless that device has `Hidraw=1`, and with it the pad comes in as
`is_hidraw 1, is_gamepad 0`, which XInput never opens.
-NotProton installs `winebus-winecx-<build>.so`: that winecx tree's own, built with
+Bridgeplay installs `winebus-winecx-<build>.so`: that winecx tree's own, built with
`SONAME_LIBSDL2` = `libSDL2-2.0.0.dylib`, the name the WineHQ engine's `winebus.so` dlopens.
SDL's bus then presents the pad as a gamepad (`is_gamepad 1`), the device XInput opens.
dyld resolves the leaf name through the caller's `LC_RPATH`s, and `winebus.so` carries
@@ -262,20 +262,20 @@ name CrossOver gives it when it copies it into each prefix. The prefix's placeho
## Using D3DMetal with your own Game Porting Toolkit
-Apple's licence does not let NotProton redistribute D3DMetal, so you supply it:
+Apple's licence does not let Bridgeplay redistribute D3DMetal, so you supply it:
1. Download the Game Porting Toolkit from Apple:
https://developer.apple.com/download/all/?q=Game%20Porting%20Toolkit (free Apple
developer account).
2. Open the disk image ("Evaluation environment for Windows games").
3. Copy the **contents of its `redist/lib` folder** into
- `~/Library/Application Support/notproton/gptk/`, so you end up with `gptk/external/` and
+ `~/Library/Application Support/bridgeplay/gptk/`, so you end up with `gptk/external/` and
`gptk/wine/`.
-4. In NotProton's Status page, press **Rescan** on the "Game Porting Toolkit" row. It turns
+4. In Bridgeplay's Status page, press **Rescan** on the "Game Porting Toolkit" row. It turns
green with "Linked from <path>." If the WineCX engine is not installed yet, "Download & Set
Up" on the "WineCX Engine" row links it during setup.
-NotProton looks in this order and links the first complete copy: that folder (the
+Bridgeplay looks in this order and links the first complete copy: that folder (the
`redist` folder itself, or the whole volume, is also accepted), then
`/Applications/Game Porting Toolkit.app` (`brew install --cask gcenx/wine/game-porting-toolkit`,
which keeps it in `Contents/Resources/wine/lib`), then `~/Applications/Game Porting Toolkit.app`.
@@ -284,7 +284,7 @@ A copy counts only when `external/libd3dshared.dylib`, `external/D3DMetal.framew
`wine/x86_64-windows/{d3d10,d3d11,d3d12,dxgi}.dll` are all present and each forwarder carries
the `Wine builtin DLL` marker. GPTK 4.0 beta 2 also has `wine/x86_64-unix/<name>.so` (links
to `../../external/libd3dshared.dylib`), `nvapi64` and `nvngx-on-metalfx`, `License.rtf` and
-`SOURCE.txt`; the unix halves and nvapi64 are linked when present. NotProton only reads the
+`SOURCE.txt`; the unix halves and nvapi64 are linked when present. Bridgeplay only reads the
folder.
## Risks
@@ -311,7 +311,7 @@ folder.
- **The CrossOver user profile.** A prefix built by another engine keeps its profile under
`users/<name>`, while CrossOver-lineage Wine uses `users/crossover`
([frankea notes](https://github.com/frankea/Whisky/releases/tag/v4.5.105-beta.1)).
- NotProton prefixes are tied to one build, so this only matters if a prefix is moved
+ Bridgeplay prefixes are tied to one build, so this only matters if a prefix is moved
between engines.
- **Bridge compatibility is inferred, not run.** `ntdll.so` exports a superset of stock
11.15's (299 → 302 symbols), so `lsteamclient.so` resolves. The PE `ntdll.dll` exports were
@@ -325,11 +325,11 @@ folder.
https://github.com/3Shain/dxmt/tree/e94c312f5c054263acf261cfa109edf13e757587), DXVK zlib, MoltenVK Apache-2.0. The tarball also
bundles nixpkgs libraries: ffmpeg 7.1.1 built `--enable-gpl` with x264/x265 (GPL-3.0+),
and gstreamer's fdk-aac plugin. It ships **no licence texts**, and winecx-gptk has no
- licence of its own. NotProton only downloads the upstream release on the user's machine
+ licence of its own. Bridgeplay only downloads the upstream release on the user's machine
and redistributes none of it. Anyone mirroring the archive takes on those obligations.
- **Rosetta.** The engine is x86_64 and Apple has said Rosetta is largely going away in
macOS 28. D3DMetal is x86_64 only too (winecx-gptk README).
-- **GPTK authenticity.** NotProton checks the builtin marker and file presence but not Apple's
+- **GPTK authenticity.** Bridgeplay checks the builtin marker and file presence but not Apple's
code signature (Whisky checks both, in `GPTKImporter+Authenticity.swift`). The payload is
a local folder the user chose.
@@ -374,4 +374,4 @@ python3 apply.py <ntdll.dll> <out> <detour bin> # patched hashes
The unpack test (`FreeEngineWinecxTests.unpacksRealArchive`, once per release) checks all of
this against the real archive when `NOTPROTON_WINECX_ARCHIVE` points at it, or when it sits in
-NotProton's download cache.
+Bridgeplay's download cache.
diff --git a/docs/dualsense-bluetooth.md b/docs/dualsense-bluetooth.md
index 8a8eb32..2534037 100644
--- a/docs/dualsense-bluetooth.md
+++ b/docs/dualsense-bluetooth.md
@@ -1,6 +1,6 @@
# DualSense Bluetooth transport
-NotProton builds and packages `controllers/dualsense` with its runtime.
+Bridgeplay builds and packages `controllers/dualsense` with its runtime.
The launcher and broker run per game session; the injected facade contains
arm64 and x86_64 slices.
@@ -90,7 +90,7 @@ write deadline independently, so a blocked IOKit call cannot hang shutdown. Clea
only when the game touched them.
Runtime files and diagnostics are under
-`~/Library/Application Support/notproton/controllers/dualsense/`.
+`~/Library/Application Support/bridgeplay/controllers/dualsense/`.
The `sessions/<AppID>-status.json` file contains transport counters. The
`sessions/<AppID>.json` file contains a temporary credential and should not be
included in issue reports. The launcher removes it on normal exit.
diff --git a/docs/game-mode-host.md b/docs/game-mode-host.md
index e1f04f9..0fd0340 100644
--- a/docs/game-mode-host.md
+++ b/docs/game-mode-host.md
@@ -15,7 +15,7 @@ external launchers retain their original identities. This avoids assigning
the game icon to every service in the prefix.
Both helpers are built and included in the normal app payload. Installation
-and integrity checks cover them, and removing NotProton removes them with its
+and integrity checks cover them, and removing Bridgeplay removes them with its
support directory.
This declares eligibility and preserves application identity. macOS still