Installing on Mac OS X

macos
#1

macOS Catalina is NOT supported at this time.

(we are looking into compatibility issues at this time, and do not have a timeframe on resolving this yet)

Normal Installation

To reduce size we split the application into two parts, the main axoloti application, and a runtime which contains other required files. You must download and install both initially.
(Usually updates will only require the main application to be downloaded and installed.)

  1. download both application bundle and axoloti_runtime
  2. install axoloti runtime:
    • open axo_runtime_osx_(version).dmg
    • drag the axoloti_runtime folder to /Applications
    • you will now have a folder /Applications/axoloti_runtime/platform_osx
  3. install application:
    • double clicking on package
    • drag Axoloti app to Applications
  4. Connect Axoloti Core board
  5. Run Axoloti application in Applications folder

Thats it your done,
Happy patching

Recommended Platform

Axoloti runs on many platforms and variations, but we are only able to test on limited number of platforms, if you experience issues we recommend the following, as these are our test platforms.

  • Mac OS X 10.10.3+
  • Java 1.8

*recommended java version is 1.8 from https://java.com/en/download/

Developer installation (from source)

If you are a developer and would like to follow the most up to date developments, and perhaps contribute to Axoloti development you can install from the Axoloti github repo

if you are running Mac OSX 10.11+ (El Capitan) you will need to install a Java JDK, you should use the Oracle install, JDK 1.8. this needs to be done 'manually' as Oracle require you to accept their license. you will also need to install ant, and ensure it is on your path.

  • clone from github
  • run build.sh in platform_macosx
  • run ./Axoloti.sh

Note: to create the bundles you will need to install the Oracle Java 8 JDK

Note: Mac OS 10.11 (El Capitan) should work, but is currently not fully tested, please report any issue on the helpdesk thread.

El Capitan - Mac OSX 10.11
Patcher won't go live
I recieved my first Axoloti yesterday and i'm having lots of problems on OSX 10.11.6 El Capitan
Can't load any patch from library: Message:"Compiling patch failed"
Compiling error when going live with any patch
Getting started...patcher won't start up right
#4

When you have Xcode installed, and automatic App Store updates enabled, you may run into an issue that patches don't compile when Xcode has been updated to a new version. I ran into this problem last week when I tried to use Axoloti on an El Capitan machine.

You might get this error message in the Axoloti console: Agreeing to the Xcode/iOS license requires admin privileges, please re-run as root via sudo. (See screenshot)

Fixing it is easy: just launch Xcode, and agree to the new license agreement. After doing that, you will be able to compile patches again.

axoloti-xcode-license.png826x397 41.9 KB

Potential user - general questions
#5

As of a few months back (version 1.0.11), it is also possible to install Axoloti through Homebrew with

brew install Caskroom/cask/axoloti

so the process for Mac is much easier now if you're a Homebrew user.

#6

1.0.11 is no longer supported. (btw, do you also have the runtime as a brew cask?)
Personally, Id recommend users always download the latest version from the official GitHub release... it only requires dragging two folders to the Application folder... not really a hard install :wink:

fyi, uninstall is simply, delete folders in Applications, and the Axoloti folder in the documents directory, no other files are created/installed on to your mac.

#7

I guess my phrasing was a bit unclear, but the current release 1.0.12-1 is also available on Homebrew :wink: 1.0.11 was just the first version. As a person used to Linux package management systems I find manually downloading files to install something of a bygone era, and the benefit of using something like Homebrew is that it's trivial to keep your apps up to date.

Of course there are situations where people need to be mindful of version compatibility with their Axo stuff when updating and need to take the proper precautions (eg. store backups and so forth).

To each their own! :slight_smile:

#8

Yes, this is released separately and automatically installed and updated with the main app, so you don't need to do anything else than installing "axoloti" itself.

#9

yeah, as a developer (both mac and linux) , I do use homebrew on the mac for things like dev tools/libs, but don't see any advantage with applications, there just isn't the coverage and of course no commercial applications - it'd be a 'partial solution' (unlike apt etc on linux), so I don't bother with it for normal apps.
also for application developers its not attractive, a) non-developers don't like command line tools b) end users don't have homebrew installed, so you have to install that first (ok, that's trivial but still a step)

but each to their own :slight_smile:

Just got Axoloti cannot make it work
#10

New users: There are some issues when running the Axoloti Patcher on macOS Catalina. An overview on how to fix these issues can be found in this topic:

Getting started...patcher won't start up right