Skip to content

Run from source on Apple Silicon macOS - #15

Merged
10-X-eng merged 5 commits into
stevecad:mainfrom
M3NT8L-One:macos-pr
Nov 1, 2026
Merged

10-X-eng merged 5 commits into
stevecad:mainfrom
M3NT8L-One:macos-pr

Conversation

@M3NT8L-One

Copy link
Copy Markdown
Contributor

This adds the first step of macOS support, as discussed in #3: running Steve from source on Apple Silicon. It doesn't add packaging, signing, a .app bundle or a Mac update feed.

What changes

  • Platform id. local_updates.update_platform() reports macos-arm64 on Apple Silicon. Portable updates stay limited to windows-x64 and linux-x64, so a Mac never tries to download an update. Intel Macs, including Rosetta, stay unidentified as before.
  • Blender discovery. On macOS, blender_runtime looks for /Applications/Blender.app/Contents/MacOS/Blender, then ~/Applications/Blender.app/.... The Windows and Linux search paths are unchanged. There is no pinned Darwin download, so automatic Blender install stays unavailable on macOS.
  • Paste event filter. On macOS the CAD paste filter goes on the CAD view, the way Linux already does it. An application-wide filter crashes PySide6 6.12 inside Shiboken while Qt Quick is running. Windows still installs it on QApplication.
  • Docs. The new docs/MACOS.md covers running from source: Python 3.13, Node, Blender.app, Keychain, install, launch, how Blender is found, and the current limits. README.md and CONTRIBUTING.md link to it.
  • Tests.
    • Darwin, Linux and Windows Blender discovery, using platform and filesystem mocks.
    • The macos-arm64 id, and a check that it doesn't turn on portable updates.
    • Which object gets the paste filter on each OS.
    • The download tests that need a packaged platform are pinned to Linux x64, so the SHA-256 and size-cap checks still run on a Mac host.

The /tmp → /private Git path issue is already fixed on main by #1. This branch has no change there and doesn't mention it as a limitation.

Testing

  • Linux VM, same 30 vault-free modules before and after: upstream c28c96f ran 108 tests and this branch ran 114. Six new tests were added, and all of them pass. The other failures are the same names on both, and they come from CAD packages missing on that VM.
  • Mac Studio (Apple Silicon), from source: tests.test_blender_runtime, tests.test_cad_webview and the platform-id test, 18 tests, all OK. Keychain-backed tests were not run over SSH.
  • Independent testing: Thanks to @TheronRogers, who tested the earlier macos-step1 branch (c9581d7) on Apple Silicon. Everything passed except the /tmp Git path test, which Keep Blender on the host CPU and fix a few path and download checks #1 has since fixed. He offered to rerun his checks against this PR.

Not in this PR

  • Packaging, code signing and notarization
  • A Mac update feed
  • A pinned Blender download for macOS
  • Intel Mac support

cursoragent and others added 5 commits November 1, 2026 17:38
macos-arm64 is a platform id for desktop features. Portable updates stay limited to the existing Windows and Linux feeds. Blender discovery checks the system and user Blender.app bundles, and docs/MACOS.md covers running from source.

Co-authored-by: M3NT8L-One <M3NT8L-One@users.noreply.github.com>
The SHA-256 rejection check was following the host architecture, so Darwin raised before the archive was hashed. The test now requests the Linux x64 package on every host. Note the macOS /tmp symlink Git failure in the source-run doc.

Co-authored-by: M3NT8L-One <M3NT8L-One@users.noreply.github.com>
PySide6 6.12 crashes when an application-wide event filter sees private Qt Quick objects. macOS now uses the same view-only filter as Linux. Windows still installs the filter on QApplication.

Co-authored-by: M3NT8L-One <M3NT8L-One@users.noreply.github.com>
Upstream main already allows a symlink above a checkout. The step-1 note that this still fails on macOS no longer applies.

Co-authored-by: M3NT8L-One <M3NT8L-One@users.noreply.github.com>
On Darwin the unpinned test refused the architecture before the size cap. The other install tests already select a packaged platform.

Co-authored-by: M3NT8L-One <M3NT8L-One@users.noreply.github.com>
@TheronRogers

Copy link
Copy Markdown

Retested PR head eff8740 on native Apple Silicon: macOS 26.6.2, Python 3.13.16, PySide6 6.12.0, Node 24.22.2 and Blender 4.5.15 LTS.

Validation results:

  • Frontend production build and native desktop smoke check passed. The mounting-plate sample built and displayed correctly.
  • Selected automated suites: 70 passed, 4 Windows-only skips, no failures. This includes CAD build/edit/export/reopen/rollback, launch services, Blender discovery, WebView, service, runtime, sync, MCP authentication and feature tests.
  • Git push/pull/import and the ancestor-symlink regression passed using the default macOS temporary directory, without the earlier workaround.
  • The full stock Blender acceptance check passed, including previews, edits, cache reuse, .blend save, CPU stills, MP4 animation, linked CAD, artifact downloads, failure recovery and cancellation.
  • Manual clipboard checks passed: multiline Unicode text in source and chat, plus Command-V image paste from Preview. Each paste produced one insertion or attachment.

One test portability issue surfaced during review: the new Windows-discovery test constructs PosixPath, which Python 3.13 rejects on native Windows. I prepared a small test-only patch that captures the host’s concrete path type before mocking the platform. All 15 Blender runtime tests pass with that change on this Mac; native Windows execution still needs verification.

These were selected suites rather than the full repository suite. Interactive Blender launch is mocked by the acceptance check; live account sign-in, production Studio sync, Intel/Rosetta and packaged distribution remain untested.

@10-X-eng
10-X-eng merged commit 0cd709d into stevecad:main Nov 1, 2026
3 checks passed
@M3NT8L-One
M3NT8L-One deleted the macos-pr branch November 4, 2026 00:39
@10-X-eng 10-X-eng mentioned this pull request Nov 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants