Repository navigation
Installation
Install the prebuilt app unless you want to work on the port itself. For source builds, use Environment Setup.
- An Apple Silicon Mac; Intel Macs are not supported by these builds.
- macOS 26 or newer, because the current renderer requires Metal 4.
- Internet access to download the Zero-K game and maps, and for online play.
- Steam installed and running only if you want Steam login.
You do not need developer tools, Mono, .NET, Wine, or Rosetta to run a prebuilt app. Homebrew is needed only for the optional Homebrew method below.
- Open the latest ZkMacOS release
and download
Zero-K-macOS-arm64.dmgand (optionally) its.sha256checksum file. - Open the DMG and drag Zero-K onto Applications using the arrow.
- Eject the disk image and open Zero-K.app from Applications.
- Approve the app in macOS if needed, then sign in or choose offline play. The lobby downloads the game and required maps as needed; these are not included in the DMG.
(Optional) Place the checksum file beside the DMG and verify it in Terminal from that directory:
shasum -a 256 -c Zero-K-macOS-arm64.dmg.sha256The release download is a DMG containing Zero-K.app. Install that app into Applications; do not run it from the mounted disk image. The repository’s Source code ZIP/tarball assets are for development.
The app is not Developer ID signed or notarized. Its ad-hoc signatures do not identify an Apple-verified publisher, so downloaded copies may be blocked. Only approve a copy whose source you trust.
After attempting to open it, use System Settings → Privacy & Security → Open Anyway if available. Alternatively, remove quarantine from that specific trusted copy:
xattr -dr com.apple.quarantine "/Applications/Zero-K.app"See Apple’s app approval instructions for more detail.
A startup dialog explains that this client is unofficial and experimental. Choose I Understand to continue. You can use a normal Zero-K account or offline play; Steam is optional. For Steam login, start the regular Steam client and sign in before opening Zero-K.
Continue to Configuration, Updating and Uninstalling, or Troubleshooting.
Install Homebrew if you do not have it, then add this repository as a tap and install the cask:
brew tap smallketchup82/zkmacos https://github.com/smallketchup82/ZkMacOS.git
brew trust --cask smallketchup82/zkmacos/zkmacos
brew install --cask smallketchup82/zkmacos/zkmacosThe trust command authorizes this third-party cask specifically. Review this repository before granting trust. If
your older Homebrew version does not provide brew trust, omit that line.
Open Zero-K.app from Applications and follow the macOS approval instructions above if needed. If you already installed manually, move the old app out of Applications first so Homebrew can manage its own copy. Keep your Application Support folder.
See Homebrew tap trust for how third-party cask trust works.
ZkMacOS source · Download the DMG · Report a bug · Get help
Unofficial, experimental Zero-K client. These guides describe the current source; older releases may differ.
- Getting Started
- Playing Zero-K
- Development
- Contributing
- Environment Setup
- Build and Release
- Internals and Validation
- Licensing and Credits
- Source · Downloads