Skip to content

Releases

202610.29.1

Choose a tag to compare

@smallketchup82 smallketchup82 released this 29 Oct 07:12

Unofficial, experimental Zero-K client for Apple Silicon Macs running macOS 26 or newer.

Download the DMG and drag Zero-K.app into Applications; see the installation guide.

Main Changes

  • Added Telemetry

Source commit: c6c2f42

Full Changelog: 202610.29.0...202610.29.1

202610.29.0

Choose a tag to compare

@smallketchup82 smallketchup82 released this 29 Oct 05:05

Unofficial, experimental Zero-K client for Apple Silicon Macs running macOS 26 or newer.

Download the DMG and drag Zero-K.app into Applications; see the README for installation instructions.

Main Changes

  • New experimental HDR output mode
  • New experimental GPU resource sharing feature, which attempts to optimize the GPU work that has to be done for features like MetalFX, HDR, etc.
  • New experimental DisplayLink feature which attempts to optimize frame pacing.
  • New announcer widget that is on by default, and announces to lobbies whenever a game you're playing in starts, that you're playing on ZkMacOS, so unexpected crashes or downtime should be expected. This announcer has both a chat component and a marker component, both of which can be toggled in the Game tab of the lobby settings.
  • Moved auto updater settings from the menu bar over to the application menu.
  • Fixed bugs & layout issues with the notchful display.
  • Other bug fixes and improvements.
  • Other developer-specific changes.

Source commit: a294e8a

Full Changelog: 202610.27.2...202610.29.0

ZkMacOS 202610.27.2

Choose a tag to compare

@github-actions github-actions released this 27 Oct 15:04

Unofficial, experimental Zero-K client for Apple Silicon Macs running macOS 26 or newer.

Download the DMG and drag Zero-K.app into Applications; see the repository README for macOS approval instructions and alternate installation methods.

Source commit: 29c0c55

Full Changelog: 202610.27.1...202610.27.2

ZkMacOS 202610.27.1

Choose a tag to compare

@github-actions github-actions released this 27 Oct 12:45

Unofficial, experimental Zero-K client for Apple Silicon Macs running macOS 26 or newer.

Download the DMG and its SHA256 checksum. Drag Zero-K into Applications; see the repository README for macOS approval instructions. The app is ad-hoc signed and is not notarized. Settings and downloaded content remain in Application Support.

Includes optional MetalFX spatial upscaling, configurable in lobby Graphics settings, in-game Display settings, or springsettings.cfg. It is disabled by default and works with Retina text and UI mode. Its extra graphics transfers may reduce FPS.

This automated build passes settings tests and the bundle audit. CI does not establish multiplayer synchronization, GPU rendering correctness, or long-session stability. Report port bugs in this repository, not to the official Zero-K developers.

Source pins and native dependency metadata are attached. OpenAI Codex assisted with this port and its release tooling.

Source commit: d6403d4

Full Changelog: 202610.27.0...202610.27.1

202610.27.0 — First experimental macOS release

Choose a tag to compare

@smallketchup82 smallketchup82 released this 27 Oct 08:46

First experimental Apple Silicon release

ZkMacOS is an unofficial third-party client, not endorsed or supported by the Zero-K developers. Report port bugs in this repository, not upstream.

This port uses experimental technology and has not been thoroughly tested. Bugs, crashes, and rendering issues are expected. Play ranked games at your own risk; a client crash and any resulting Elo loss are your responsibility.

Requirements

  • Apple Silicon Mac running macOS 26 or newer (Metal 4).
  • Steam installed and running only if you want Steam login.
  • No Wine, Rosetta, Mono, separately installed .NET, or developer tools needed to play.

Included

  • Native ARM64 Recoil engine, Chobby lobby, Steam helper, and CircuitAI.
  • GPU acceleration through Mesa, Zink, and KosmicKrisp to Metal.
  • Two-finger camera pan, pinch zoom, Option + two-finger tilt, and optional three-finger tilt.
  • Standard, Retina text/UI, and Full Retina rendering modes, plus a native FPS counter.
  • Self-contained Zero-K.app in a drag-to-install DMG; settings and downloads live in Application Support.
  • Defaults: windowed lobby and game, Low graphics, Retina text and UI, three-finger tilt off, and cursor locking off. Existing saved preferences are preserved.

Method 1: Homebrew

Install the versioned cask from the ZkMacOS tap:

brew tap smallketchup82/zkmacos https://github.com/smallketchup82/ZkMacOS.git
brew trust --cask smallketchup82/zkmacos/zkmacos
brew install --cask smallketchup82/zkmacos/zkmacos

The trust command authorizes this cask specifically. If your older Homebrew does not have brew trust, omit that line.

For future releases, quit Zero-K and run brew update, then brew upgrade --cask smallketchup82/zkmacos/zkmacos.

Method 2: Manual

Download Zero-K-macOS-arm64.dmg and its .sha256 file below. Verify the download:

shasum -a 256 -c Zero-K-macOS-arm64.dmg.sha256

Open the DMG, drag Zero-K into Applications, eject the image, and open the app.

The app is not Developer ID signed or notarized. For a copy you trust, approve it under System Settings → Privacy & Security → Open Anyway after the first launch attempt, or use the specific-app quarantine command in the installation guide.

Known limitations

  • The lobby can use excessive GPU resources while idle; tracked in #4. Lobby throttling has not been implemented in this build.
  • Multiplayer synchronization, full matches, long sessions, and installation on other Macs still need broader validation. Successful server connections are not synchronization proof.
  • Intermittent missing UI panel backgrounds and some optional graphics effects remain under investigation. Higher graphics settings and Full Retina may expose bugs or reduce performance.
  • See remaining testing and known limitations.

Source, licensing, and AI disclosure

The existing verified app/DMG is used for this release. The attached sources.lock.json identifies its engine, lobby, and helper revisions; source repositories and build instructions are linked in the README. The release tag also includes subsequent documentation, licensing, and Homebrew tooling updates, which do not change the gameplay binaries.

Original ZkMacOS work is GPL-2.0-or-later. Upstream code and dependencies retain their licenses, including the GPLv3 launcher. LICENSE and THIRD-PARTY.md are attached, and the app carries bundled dependency notices. This port was developed with substantial OpenAI Codex assistance; that does not establish correctness or stability.