Skip to main content

Download and Setup

Requirements​

The QExE tool is designed for Windows PC and requires the following software:

  • MaxMSP 8 (free runtime version is sufficient) — Windows 64-bit
  • Unity 2021.3 LTS
  • Git LFS
    • Both project repositories use Git LFS to store large files. Git LFS should be installed on your system before cloning.

For third-party notices covering additional SDKs and packages, see the License page.

Project Structure​

When installing the MaxMSP Controller and Unity Agent on the same machine, the recommended project structure is:

my-qexe-project
├── qexe_controller             <- git clone
│   ├── src
│   └── testfiles
├── qexe_agent_unity_project    <- git clone
│   ├── Assets
│   ├── ...
├── my_test_content_directories
│   ├── scene_1_objectAudioFolder
│   │   └── monoAudioFile_1.wav
│   │   └── monoAudioFile_2.wav
│   └── scene_2_AmbisonicsAudioAndVideoFolder
│       ├── multichannelAudioFile.wav
│       └── videoFile.mp4
└── my_local_folder_of_files
    ├── plugin_1.dll
    ├── plugin_1_mappingfile.js
    └── myHRTF.sofa

MaxMSP​

Download​

cd ./my-qexe-project
git clone git@github.com:qoevave/qexe_controller.git

One-time setup​

Once MaxMSP has been installed on your machine, a one-time operation needs to be done to add the correct file path to Max's search directory.

  1. Open MaxMSP
  2. Navigate to Options > File Preferences
  3. Add a new file path
  4. Browse to the directory of the MaxController
  5. Close Max. The next time you open MaxMSP, it will search this directory.

Unity​

Download​

cd ./ my-qexe-project
git clone git@github.com:qoevave/qexe_agent.git

Once downloaded, the Unity Agent project can either be open directly or via the Unity hub.