How notprotonnot/notproton works
NotProton is a macOS application that enables Steam Play in macOS Steam and ports Proton components to macOS. Users inspect system status, prepare a CrossOver runner and Valve payload, then manage Wine prefixes and launch Windows programs; Steam itself consumes the installed compatibility tool. The dylib resolves Steam internals and installs hooks, while lsteamclient and steam-shim provide ported runtime components. The README documents these capabilities, but several implementation files were not sampled, so some subsystem connections are documented or left unverified rather than inferred from names alone.
Main entry points: SystemStatus.swift System workflow · PrefixesModel.swift Prefix coordinator · hooks.c Steam hooks · RunnerInstaller.swift Runner installer
Components 30
macOS app
- Status UI
app/Sources/NotProtonApp/Views/StatusView.swift - Prefix UI
app/Sources/NotProtonApp/Views/PrefixesView.swift - Backup UI
app/Sources/NotProtonApp/Views/BackupsView.swift - System workflow
app/Sources/NotProtonApp/SystemStatus.swift
Runner setup
- CrossOver license
app/Sources/NotProtonApp/Model/CrossOverLicense.swift - CrossOver source
app/Sources/NotProtonApp/Model/CrossOverSource.swift - Runner installer
app/Sources/NotProtonApp/Model/RunnerInstaller.swift - Runner store
app/Sources/NotProtonApp/Model/RunnerStore.swift - ntdll patching
app/Sources/NotProtonApp/Model/NtdllPatcher.swift - Valve payload
app/Sources/NotProtonApp/Model/PayloadState.swift - Valve fetcher
app/Sources/NotProtonApp/Model/ValveFetcher.swift - Steam installer
app/Sources/NotProtonApp/Model/SteamInstaller.swift - Steam repair
app/Sources/NotProtonApp/Model/SteamRepair.swift - Uninstall
app/Sources/NotProtonApp/Model/Uninstall.swift
Prefix management
- Prefix coordinator
app/Sources/NotProtonApp/PrefixesModel.swift - Prefix store
app/Sources/NotProtonApp/Model/PrefixStore.swift - Prefix tools
app/Sources/NotProtonApp/Model/PrefixTools.swift - Prefix rebuild
app/Sources/NotProtonApp/Model/PrefixRebuild.swift
Steam runtime
- lsteamclient port
lsteamclient/steamclient_main.c - Steam helper shim
steam-shim/steam.cpp
Hook internals
- Dylib loader
dylib/core/loader.c - Signature resolver
dylib/resolver/resolver.c - Anchor matching
dylib/resolver/anchor.c - Mach-O reader
dylib/core/macho.c - Steam hooks
dylib/hooks/hooks.c - Compatibility feature
dylib/feats/compat.c - Web patching
dylib/feats/webpatch.c - Web UI feature
dylib/feats/webui.c
Other components
- User
- macOS Steam
Connections 28
- User → Status UI: reviews status
- User → Prefix UI: manages prefixes
- Status UI → System workflow: requests actions
app/Sources/NotProtonApp/Views/StatusView.swift - Prefix UI → Prefix coordinator: invokes management
- Backup UI → Prefix coordinator: manages backups
- System workflow → CrossOver license: checks license
app/Sources/NotProtonApp/SystemStatus.swift - System workflow → CrossOver source: selects source
app/Sources/NotProtonApp/SystemStatus.swift - System workflow → Runner installer: sets up runner
app/Sources/NotProtonApp/SystemStatus.swift - System workflow → Valve fetcher: fetches binaries
app/Sources/NotProtonApp/SystemStatus.swift - System workflow → Steam installer: installs Steam
app/Sources/NotProtonApp/SystemStatus.swift - System workflow → Steam repair: repairs Steam
app/Sources/NotProtonApp/SystemStatus.swift - System workflow → Uninstall: removes setup
app/Sources/NotProtonApp/SystemStatus.swift - System workflow → Valve payload: reads payload state
app/Sources/NotProtonApp/SystemStatus.swift - Runner installer → Runner store: stages builds
- Runner installer → ntdll patching: patches runner
- Prefix coordinator → Prefix store: loads prefixes
app/Sources/NotProtonApp/PrefixesModel.swift - Prefix coordinator → Prefix tools: opens tools
app/Sources/NotProtonApp/PrefixesModel.swift - Prefix coordinator → Prefix rebuild: rebuilds prefixes
- macOS Steam → Dylib loader: loads dylib
- Dylib loader → Signature resolver: resolves signatures
dylib/core/loader.c - Dylib loader → Steam hooks: installs hooks
dylib/core/loader.c - Signature resolver → Anchor matching: matches anchors
- Signature resolver → Mach-O reader: inspects image
- Steam hooks → Compatibility feature: dispatches compat hooks
- Steam hooks → Web patching: dispatches web hooks
- Steam hooks → Web UI feature: dispatches UI hooks
- macOS Steam → lsteamclient port: loads port
- macOS Steam → Steam helper shim: uses helper