agentdavidjoseph / magenta-studio

Magenta Studio is a collection of music plugins built on Magenta’s open source tools and models

This repo is where the code to Magenta Studio is maintained. For information, support and installation instructions of the tools themselves go to this website

This is not a Google product.

Overview and Organization

The Magenta Studio plugins are Electron apps. Electron has the advantage of being a cross platform solution that works well with magenta.js. The code for each of the plugins is located in a folder with the same name.

All of the plugins share common UI and communication components which can be found in the 'components' folder. These objects are built using Polymer's LitElement.

The Ableton integration is achieved through Max4Live. The object and related javascript files can be found in the folder called 'magenta4live.amxd'. The Max component and the Electron apps communication over a local server running on port 3333.

Installation

If you have node.js and npm installed on your computer, all of the dependencies can be installed by running

npm install

Building

The modules come as both standalone apps and Ableton integrated. To build all versions (Linux standalone and Mac, Windows in standalone and Max For Live formats) run:

npm run build

All of the build files will be put into the 'dist' folder.

You can also build a specific target by passing it as an argument:

npm run build macos-standalone

The current options are:

• windows-ableton
• windows-standalone
• linux-standalone
• macos-ableton
• macos-standalone

Note: if you want to build Windows versions from Mac, you need to have Wine installed.

License

Copyright 2018 Google Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.