Skip to content
smallketchup82 edited this page Oct 29, 2026 · 2 revisions

Welcome to the ZkMacOS wiki.

ZkMacOS packages Zero-K for Apple Silicon Macs running macOS 26 or newer, with GPU acceleration, native trackpad controls, Retina rendering, and a self-contained Zero-K.app.

This is an unofficial, experimental client. The Zero-K developers do not endorse or support it. Crashes and rendering problems are possible; multiplayer synchronization and long-session stability still need broader testing. Report port-specific problems to ZkMacOS, not the official Zero-K developers.

Getting started

  1. Download the DMG and install Zero-K.app. No developer tools, Mono, .NET runtime, Wine, or Rosetta are needed to play.
  2. Open the app, approve the downloaded copy in macOS if needed, and sign in or choose offline play. The lobby downloads the game and maps separately.
  3. Read Configuration, then adjust graphics or trackpad controls for your setup.
  4. Use Troubleshooting if something fails, Getting Help for questions, or Reporting Bugs for reproducible problems.

Homebrew is an optional installation convenience. The DMG is the primary download.

Two places to configure

The lobby's Graphics settings and the game's Settings → Graphics → Display menu share the macOS display options. Trackpad controls live in the in-game camera settings. Game and interface settings cover startup announcements, cursor capture, and window behavior.

Settings and downloaded content live in Application Support, separately from the app. Updating the app does not reset that data.

Developing ZkMacOS

Start with Environment Setup, then Building and Testing. The release guide builds locally and opens an unpublished GitHub draft for you to edit and publish. Contributing explains which fork should receive a PR.

The engine, lobby, launcher and AI are separate repositories pinned by the source lock. Engine updates merge the next release tag required by Zero-K into the macOS fork.

These guides describe the current source. Older published releases may have fewer settings; check your installed release before reporting a missing option. See Known Issues for the current limitations and the README for the feature/difference list.

Clone this wiki locally