Overview#

Magenta RealTime 2 ships a bundle of native apps, plugins, and extensions built on the same portable C++ inference engine (magentart::core).

Jam (App), try this first!#

An easy way to jump straight into playing and jamming with the model, packed with presets. Runs as a self-contained standalone app.

Collider (App)#

Mix and mash prompts on a 2D surface and let your ideas collide to create new genres and sonic mixtures. Runs as a self-contained standalone app.

MRT2 (Plugin & App)#

DAW integration and raw access to the MRT2 model itself for maximum control. Ships as both an AUv3 instrument plugin and a Standalone app.

Creative Coding (Extensions)#

Extensions for popular creative coding environments, giving you the tools to quickly build your own experiences:

  • Max MSP: mrt~.mxo

  • Pure Data: mrt~.pd_darwin

  • SuperCollider: MRT2.scx

When you’re ready to share a build with someone else, see Distributing the macOS apps.

If you want to build your own new application using the magentart::core inference engine, see the Developer Guide.

Prerequisites#

All three apps need Node (for the React UI build):

brew install node

They also need the shared resources (MusicCoCa, SpectroStream) and at least one pre-exported model. Download them with the mrt models CLI — see Models & checkpoints.

Build & deploy#

The build pattern is identical for every app — only the CMake target changes:

source .venv/bin/activate
cmake . -B build
cmake --build build --target <deploy-target> -j10

App

Deploy target

Deployed to

Audio Unit plugin

deploy_mrt2_au

~/Applications/MRT2 (AU).app

Standalone

deploy_mrt2_standalone

~/Applications/MRT2.app

Jam

deploy_mrt2_jam

~/Applications/MRT2 - Jam.app

Collider

deploy_mrt2_collider

~/Applications/MRT2 - Collider.app

Each deploy_* target signs the bundle with an ad-hoc signature (CODESIGN_IDENTITY=-), which is fine on your own machine. To run a build on another Mac, see Distributing the macOS apps.

The per-app pages cover anything specific to that app — how to register or launch it, and how to use it.