Windows-Steam-Wrapper-for-macOS

mysteamwine.py is a Python CLI for managing a Wine bottle dedicated to Steam on macOS.

Current module layout:

• mysteamwine/runtime.py: shared process execution, downloads, executable resolution
• mysteamwine/bottle.py: bottle paths under ~/Library/Application Support/MySteamWine/
• mysteamwine/winetricks.py: winetricks integration
• mysteamwine/dxmt.py: DXMT install from a local directory or .tar.gz
• mysteamwine/dxvk.py: DXVK install from a local directory or .tar.gz, including DXVK-macOS
• mysteamwine/steam.py: Steam installer/runner and manifest parsing
• mysteamwine/scanner.py: game folder scanner
• mysteamwine/advisor.py: rule-based dependency recommendations

Basic usage:

# show environment and bottle paths
python3 mysteamwine.py info

# initialize a bottle
python3 mysteamwine.py --wine64 /opt/homebrew/bin/wine init

# download and install Steam
python3 mysteamwine.py --wine64 /opt/homebrew/bin/wine install-steam

# launch Steam
python3 mysteamwine.py --wine64 /opt/homebrew/bin/wine run-steam

# list installed Steam games from manifests
python3 mysteamwine.py list-games

# use an existing Wine prefix directly instead of a managed bottle
python3 mysteamwine.py --prefix ~/.wine-bluearchive info
python3 mysteamwine.py --prefix ~/.wine-bluearchive list-games

# launch a game by Steam AppID
python3 mysteamwine.py --wine64 /opt/homebrew/bin/wine launch-game --appid 620

Dependency tools:

# install winetricks verbs into the bottle
python3 mysteamwine.py winetricks --verbs vcrun2019,d3dx9

# install DXVK from a local release archive or extracted folder
python3 mysteamwine.py install-dxvk --dxvk-source ~/Downloads/dxvk-2.3.tar.gz

# install Gcenx/DXVK-macOS from a local checkout or extracted folder
python3 mysteamwine.py install-dxvk --dxvk-source ~/Downloads/DXVK-macOS --dxvk-flavor macos

# install DXMT from a local checkout or extracted folder
python3 mysteamwine.py --wine /opt/homebrew/bin/wine install-dxmt --dxmt-source ~/Downloads/dxmt

# one-shot Metal setup for a prefix: wineboot + winetricks steam + DXMT
python3 mysteamwine.py --prefix ~/.wine-bluearchive --wine /opt/homebrew/bin/wine setup-metal --dxmt-source ~/Downloads/dxmt

# wipe every bottle under MySteamWine app support
python3 mysteamwine.py wipe-bottles --yes

# scan a game folder and get rule-based recommendations
python3 mysteamwine.py advise-game --appid 2056220
python3 mysteamwine.py scan-game --path "/path/to/game"

Host dependencies still need to exist on the Mac side, for example Wine, winetricks, and Vulkan loader/tools where required by the chosen Wine build.

Graphics backend defaults are now split intentionally:

• run-steam defaults to plain Wine (--graphics-backend auto resolves to none)
• launch-game and debug-game default to DXMT (--graphics-backend auto resolves to dxmt)