The Max 8.2 SDK: An Overview

    Third-party packages and external objects created by the community have been an important part of Max since the earliest days. Max 8.2 gave us the ability to run Max natively on Apple Silicon computers. The recently updated Max 8.2 SDK extends this support to third-party externals, which must be recompiled to run in Max 8.2 natively. The Max SDK build system has also been modernized with CMake support to aid in cross-platform development. Finally, for those who wish to develop using both Max SDK and the Min API, these are now updated to share the same base headers and libraries. Watch the video below for more details on the update and instructions to get started with the new Cmake-enabled workflow.

    Max 8.2 SDK Update Overview

    For more information about how to develop externals, see:
    GitHub repositories:

    by Cycling '74 on
    Jan 24, 2022 8:27 PM

    • Iain Duncan's icon
      Iain Duncan's icon
      Iain Duncan
      Jan 27 2022 | 5:55 pm
      Thanks for this! :-)
    • thomashummel's icon
      thomashummel's icon
      Mar 02 2022 | 1:54 pm
      i typed in my terminal git clone as in the video. It answers The authenticity of host ' (' can't be established. ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU. This key is not known by any other names Are you sure you want to continue connecting (yes/no/[fingerprint])? yes Warning: Permanently added '' (ED25519) to the list of known hosts. Permission denied (publickey). fatal: Could not read from remote repository.
      Please make sure you have the correct access rights and the repository exists.
      What has happened? Thank you Thomas
    • 11olsen's icon
      11olsen's icon
      Mar 02 2022 | 3:25 pm
      I had the same problem. I had to follow some steps to create a key on my machine. You need a github account. Gooogle " Permission denied (publickey)" or use docs at github. If you can't get it done, you could always download manually from github (don't forget the max-sdk-base). More important is to have homebrew / cmake accessible in your terminal.
    • Isabel Kaspriskie's icon
      Isabel Kaspriskie's icon
      Isabel Kaspriskie
      Mar 02 2022 | 3:27 pm
      Hi Thomas,
      Looks like the difference between cloning via SSH vs HTTPS is causing the error. The quick solution would be to instead use git clone --recursive
      (That --recursive flag will pull in the max-sdk-base submodule you'll need as well in one go.) For more info: With git clone, git will use ssh to pull in the repository to your local machine. This means you'll need to have SSH keys added to your GitHub account. Instructions here:
    • Rob Ramirez's icon
      Rob Ramirez's icon
      Rob Ramirez
      Mar 02 2022 | 3:28 pm
      if you are having trouble cloning from github, you can simply download the latest release here -
    • thomashummel's icon
      thomashummel's icon
      Mar 03 2022 | 12:54 pm
      Thanks a lot! Now it works...
    • benj3737's icon
      benj3737's icon
      Mar 03 2022 | 4:03 pm
      Can anyone comment on whether you need an apple-silicon machine in order to make an apple-silicon-native external? Or can it be created on an older Intel machine, but still work natively on an AS machine? Thank you!
    • Isabel Kaspriskie's icon
      Isabel Kaspriskie's icon
      Isabel Kaspriskie
      Mar 03 2022 | 4:07 pm
      You don't need an Apple Silicon machine to make an M1 native external as long as you have a recent version of Xcode.
      Requirements, to be precise, are: Xcode >=12 and MacOS >= 10.15 (Catalina)
    • srs's icon
      srs's icon
      Jun 29 2022 | 6:06 am
      Do the changes in the 8.2 SDK also explain why externals compiled in previous versions don't work in Max 8.2 onwards? I have an external that was working fine in 8.1 and the moment I updated to 8.2 it stopped working.
      I'm trying to determine whether I need to re-compile this external with the 8.2 SDK in order to continue using it in Max 8.2 (even if I'm still on Catalina or Big Sur) ?
      For context, it's the old Fingerpinger external for use with the Apple trackpad and it makes use of the Apple MultitouchSupport.framework (/System/Library/PrivateFrameworks/MultitouchSupport.framework/)
      latest source (not linked on site):
    • Julien Bayle's icon
      Julien Bayle's icon
      Julien Bayle
      Nov 22 2022 | 5:34 pm
      a (very) basic raw question: can we play with Live API through 8.2 SDK for externals running in M4L devices ??
    • Tj Shredder's icon
      Tj Shredder's icon
      Tj Shredder
      Jan 24 2023 | 11:56 am
      Trying to follow the video letter by letter. I get stuck @ cmake --help: zsh: command not found: cmake searched, but brew install cmake does not work... (homebrew-core is a shallow clone.) Then I downloaded cmake.dmg, and followed the PATH instruction which leads to this error: CMake Error: The source directory "/Users/st/max-sdk/build/help" does not exist. Specify --help for usage, or press the help button on the CMake GUI. This is 100% confusing. Those error messages are helpful for those who know what it means, but they most likely don't run into errors anyway... I would love to help somebody to make tutorials for those who know nothing. My experience is always, that it looks so nice in the video, and fails on my system. And nobody anticipated what could go wrong... I would also prefer always methods without the command line. Nothing against it in general, but for me I know better what is going on if I just copy folders and files instead of doing such things in the terminal with about 1000 keystrokes more and not really knowing what is going on... There should be either droplets or little apps to just do all these commands. Why typing all those letters, if a program could type it for everybody? Sometimes I think professional programmers are not lazy enough...
    • πŸ‘½Rβˆ†Jβˆ† The Resident βˆ†lienπŸ‘½'s icon
      πŸ‘½Rβˆ†Jβˆ† The Resident βˆ†lienπŸ‘½'s icon
      +1, even with CMake installed via homebrew, i then attempt the 'cmake -G Xcode ..' part and get this:
      sorry for being so stupid and incapable of 'modernization', Cycling74 (wasted 4 hours this morning googling everything i could with no luck #FML πŸ˜”πŸ”«)
    • 11olsen's icon
      11olsen's icon
      Jan 24 2023 | 8:11 pm
      @RAJA TRA I remember seeing the same error. Iirc I could solve it with the xcode -select command at the bottom of this thread
    • πŸ‘½Rβˆ†Jβˆ† The Resident βˆ†lienπŸ‘½'s icon
      πŸ‘½Rβˆ†Jβˆ† The Resident βˆ†lienπŸ‘½'s icon
      @11OLSEN oooof! can't thank you enough!! THANK YOU THANK YOU THANK YOU!!!! It works now! 😭 i've never been more relieved that Cycling74 won't be able to leave me behind in their fast moving dust
      (i would like to add, tho, they should show more 'empathy' for their user-base when creating documentation and tutorials, 'empathy' is required for proper 'modernization' of the human spirit πŸ₯Έ)
      ok, i'm happier now. i'll leave it at that. Thanks again, @11OLSEN πŸ™
    • 11olsen's icon
      11olsen's icon
      Jan 24 2023 | 8:25 pm
      @Tj Shredder It is not easy to make a failsafe tutorials, but i totally understand you as I also had to solve multiple problems before it finally worked. I documented everything in a comment on Isabels yt vid but for some reason the comment was deleted. You should focus on a proper homebrew (+cmake) installation first.