Builds a macOS app for your own Steam or Windows copy of Quasimorph.
No game files are included here. Nothing is uploaded.
Quasimorph 1.0 running on Apple Silicon macOS from a wrapper produced by this tool.
- Apple Silicon Mac
- macOS 15 or newer
- Quasimorph in your Steam account, or a local Windows copy
- Internet for the first build
- Download
Quasimorph-for-macOS.zipfrom Releases. - Unzip it.
- Open Terminal.
- Run:
cd ~/Downloads/Quasimorph-for-macOSThe Steam install/updater flow is verified and works.
Run:
./quasimorph-macos steamThen:
- Open the DMG created on your Desktop.
- Drag
Quasimorph.appto Applications. - Open it. The official Windows Steam client installs.
- Sign in and install Quasimorph when Steam asks.
- Open
Quasimorph.appagain to play.
Your password and Steam Guard stay inside Valve's Steam client. The CLI never asks for them.
Type this, add one space, then drag your RAR, ZIP, folder, or Quasimorph.exe into Terminal:
./quasimorph-macos buildThen press Return and open the DMG created on your Desktop.
Example:
./quasimorph-macos build "/Users/me/Downloads/Quasimorph.v1.0.rar"No path? Use the picker:
./quasimorph-macos buildDesktop/Quasimorph macOS/
├── Quasimorph.app
├── Quasimorph-macOS-v1.0.dmg
└── BUILD-REPORT.txt
If macOS blocks it:
- Right-click
Quasimorph.app. - Click Open.
- Click Open again.
Rebuild the app with CLI 0.3.0 or newer. Older wrappers used Wine 10, which can lose all mouse and keyboard input after macOS changes focus. The new runtime uses Wine 11.15, where that focus bug is fixed.
If you still use an older build, relaunching the app is the only reliable workaround. Repeatedly switching away and back may restore input, but it is not a permanent fix.
On macOS 13 or 14, use the older 0.2.1 release. It can run there, but it cannot include this Wine 11 fix.
Back up your saves before replacing Quasimorph.app:
- Right-click the old app and choose Show Package Contents.
- Open
Contents/SharedSupport/prefix/drive_c/users/<your user>/AppData/LocalLow/. - Copy the
Magnum Scriptum LTDfolder somewhere safe. - Build and open the new app once, then quit it.
- Put the backup in the new app under
Contents/SharedSupport/prefix/drive_c/users/crossover/AppData/LocalLow/.
Steam Cloud may restore saves automatically, but make the backup anyway.
Run:
./quasimorph-macos doctorThen retry with details:
./quasimorph-macos build "/path/to/game.rar" --verbose- Steam mode downloads the game through the account that owns it. It does not bypass Steam.
- Steam remains responsible for Cloud, Workshop, achievements, ownership checks, and updates.
- Local mode supports RAR, 7Z, ZIP, folders, or
Quasimorph.exe; other Windows installers are not supported. - The tool downloads a checksum-verified Sikarugir template, Wine 11.15 runtime, DXVK-macOS, and 7-Zip helper.
- After Steam installs the game, the app contains account-managed game files. Do not redistribute it.
- This is an unofficial compatibility tool. It is not affiliated with Quasimorph or Magnum Scriptum.
Requires Xcode Command Line Tools:
swift test
swift build -c releaseOwn code is MIT licensed. Downloaded components keep their original licenses. See THIRD_PARTY_NOTICES.md.
