Installing Harmony Space on a Mac
Download Harmony Space as a zipped folder from here for an intel Mac or an Apple Silicon Mac (M1, M2 or later). (If you are not sure how to start this download from the Google Drive page that presents, look for the download icon in the top menu.)
Google drive security
In the case of the large all-in-one zip file, Google Drive will say something like “… is too large for Google to scan for viruses. Would you still like to download this file?” If you want to download anyway, click “Download anyway”.
We check for viruses before packaging the zip.
Unzip this Harmony Space folder and put it somewhere convenient (e.g. on the desktop).
On a Mac, you also need the HarmonySpace Midi Player helper (available here).
Mac Security
On Sonoma and later, will refuse to run with program because they do not come form the App Store and are not from a registered developer. To run them anyway, Go to Mac System Settings>> Privacy. Towards the bottom under the subheading “Security” it will say something like “… was blocked for use because it is not from a registered developer”. If you want to run it anyway, click “Open anyway”.
Having done that, first start the Harmony Space MIDI Player by double clicking on it. (If you are going to be playing with Harmony Space intermittently for a few days, you may want to leave Harmony Space MIDI player running, as it consumes very little screen space or resources, and always needs to be running before you run Harmony Space.)
In the Harmony Space folder, drop ‘Harmony Space.image’ onto Squeak.app. (Optionally, to make it easier to find the two files amongst everything else in the folder, sort the folder by size, large at the top).
If Harmony Space is not already running, press the green button marked “Press to start Harmony Space”. If everything looks well layed out, you are good to go. If the screen looks a bit jumbled or too small or too big, visit setting up the right layout for your screen size.
Possible Installation problems on Mac version
If on playing any note you get the error message “ Cannot find HarmonySpace MidiPlayer 1 in device table”, this just means you need to quit Harmony Space, run the MIDI Player first and the run Harmony Space again.
If right-clicking makes a lot of strange circles pop up, then see modifier Key setup here to fix.
If you are not getting any sound when you click on note circles, see midi setup on a Mac.
Installing Updates
Unzip the Update folder, and copy the two files it contains ( normally just HarmonySpace.image and HarmonySpace.changes) into your Harmony Space folder, overwriting the two existing files of the same name.
Quitting Harmony Space
On the Harmony Space Menu bar select Harmony Space > quit and answer ‘Yes’ to the question ‘Are you sure?’.
Saving Work
If you have created any chord sequences, or created any new chords or chord maps that you want to keep, you should save them to disk using the relevant menu popup menus or the options under the main menu item ‘Recordings’. See saving work for more detail.
Experimental Feature: Saving the state of the system
At present the system has an experimental system to allow you to continue sessions where you left off. It is still essential to first save to disk any chord sequences, chords or chord maps you created that you don’t want to lose , but you are welcome to try this system. Please let us know about any problems you may find. To use it, exist sessions using Harmony Space >save and quit, in which case the state of the previous session will be restored exactly next time you restart. The down side from this way of working is that after restarting a number of sessions, the system may get in to an undesired state, in which case you may need to partially re-install the system, and then restore any saved chord sequences, chords or chord maps you want to restore from previously saved versions.
To do a partial re-install of this kind, copy the two files (HarmonySpace.image and HarmonySpace.changes) from your installation zip or incremental update zip, which ever is more recent, into your Harmony Space folder, overwriting the two existing files of the same name.