getting-started

Getting Started (end-user web app workflow)

How do I use it?

  1. Open the Crucible Webopen in new window plugin in a browser.
  2. Copy the "token" from the top right of the plugin.
  3. Install the Runes CLI. See [Runes-CLI]/runes-cli/ for details. TLDR: pip install runes-cli
  4. Run the runes-cli in a terminal with the key word runes. Select tokens, then add, then paste the token copied from the plugin.
  5. Run a pre-made Rune. From the runes-cli, select runes (run or manage published runes) then select an available rune from the list. I recommend starting with a rune that does not require a GPU. (look for CPU) Try the Rune Template for starter.
  6. After the Rune has has started, you can interact with if from the Crucible Web plugin. Go back to the plugin and select the Connected Runes tab. You should see the Rune you started. Click on the Rune to interact with it!

Getting Started (end-user music workflow)

How do I use it?

  1. Download the plugin installer. Run it.

  2. Open https://www.ableton.com/. Find the plugin in Ableton's plugin menu: Plugin-Ins -> SignalsAndSorcery -> DAWNet.vst3. (If you don't see the plugin go to options -> preferences -> "Use VST3 plugin system folder" -> rescan) Step 1&2

  3. Open the plugin. The home view of the plugin lists remade Google Colabs. Click on a Colab to open it.

  4. From the plugin copy the "token" from top right of DAWNet VST interface. Step 3&4

  5. Paste the "token" into Colab. Find the token variable (called something similar to dawnet_token). Set the value. Step 5

  6. At this point the Plugin and the Colab server should have found each other via the underlying web-socket server.

  7. If a Python function was registered it will be translated into a web form/interface in the plugin. Files, e.x Audio & MIDI files can be dragged from the host DAW's timeline into the plugin. The plugin will handle transferring files and other input params over the network to the remote compute.
    Step 7

Workflow example

In this video I demonstrate how to use a Crucible plugin to perform audio style transfer powered by Meta's MusicGenopen in new window project.

getting-started

Last Updated:
Contributors: Steve Hiehn, stevehiehn, Steve Hiehn