Skip to main content

Mutable Instruments Ugens

Description#

Mutable Instruments is popular Eurorack module company from Normandy. The designer, engineer, and founder of Mutable Instruments, Émilie Gillet, has made all of her work open source. Volker Böhm has taken the time to port some of these modules to SuperCollider.

Reference#

Installation#

Automatic#

For debian/ubuntu/mint systems, these ugens can be installed as part of the ansible Tidal installer

Manual#

  1. Unpack the latest release from mi-Ugens appropriate to your Operating System

  2. Move the top level directory of the archive (mi-UGens/) into the SuperCollider Extensions folder (create it if it doesn't exist):

  • Linux: /home/<youruser>/.local/share/SuperCollider/Extensions/mi-UGens
  • Windows: C:\Users\<youruser>\AppData\Local\SuperCollider\Extensions\mi-UGens
  • OSX: /Users/<youruser>/Library/Application Support/SuperCollider/Extensions/mi-UGens

Note: The SuperCollider Extensions folder can be found by running Platform.userExtensionDir in SuperCollider. The path will be printed to the post window.

  1. Create a new synthdef file mi-ugens.scd, with these synthdefs
  • Linux: /home/<youruser>/.local/share/SuperCollider/synthdefs/mi-ugens.scd
  • Windows: C:\Users\<youruser>\AppData\Local\SuperCollider\synthdefs\mi-ugens.scd
  • OSX: /home/<youruser>/Library/Application Support/SuperCollider/synthdefs/mi-ugens.scd
  1. Create a new parameter definitions file, mi-ugens-params.hs, with these parameters
  • Linux: /home/<youruser>/.local/share/SuperCollider/synthdefs/mi-ugens-params.hs
  • Windows: C:\Users\<youruser>\AppData\Local\SuperCollider\synthdefs\mi-ugens-params.hs
  • OSX: /Users/<youruser>/Library/Application Support/SuperCollider/synthdefs/mi-ugens-params.hs
  1. Configure SuperCollider - edit your startup.scd:
  • Linux: /home/<youruser>/.conf/SuperCollider/startup.scd
  • Windows: C:\Users\<youruser>\AppData\Local\SuperCollider\startup.scd
  • OSX: /Users/<youruser>/Library/Application Support/SuperCollider/startup.scd
  1. Load the mi-ugens.scd synthdef in startup.scd. Use the full path from 3.

NOTE FOR WINDOWS USERS: you must use double backslashes for the load() path in startup.scd, eg load("C:\\Users\\<youruser>\...");

After:

...
~dirt = SuperDirt(2, s);
// load mi-ugens.scd synthdefs
load("FULL_PATH_TO_mi-ugens.scd");
// end load mi-ugens.scd synthdefs
  1. Configure verb and clouds as Global Effects. Add the following stanza as indicated to your startup.scd:

After:

...
~d10 = ~dirt.orbits[9]; ~d11 = ~dirt.orbits[10]; ~d12 = ~dirt.orbits[11];
);
// define global effects for mutable instruments effects
~dirt.orbits.do { |x|
var clouds = GlobalDirtEffect(\global_mi_clouds, [\cloudspitch, \cloudspos, \cloudssize, \cloudsdens, \cloudstex, \cloudswet, \cloudsgain, \cloudsspread, \cloudsrvb, \cloudsfb, \cloudsfreeze, \cloudsmode, \cloudslofi]);
var verb = GlobalDirtEffect(\global_mi_verb, [\verbwet, \verbtime, \verbdamp, \verbhp, \verbfreeze, \verbdiff, \verbgain]);
x.globalEffects = x.globalEffects
.addFirst(clouds)
.addFirst(verb);
x.initNodeTree;
};
// end define global effects for mutable instruments effects
  1. Save your startup.scd and exit

  2. You can choose to import the mi-ugens-params.hs parameter definitions manually in your tidal session, or add the following line to the BootTidal.hs file associated with your editor of choice (locating the correct BootTidal.hs is beyond the scope of this reference)

...
:script "FULL_PATH_TO_mi-ugens-params.hs"
^:set prompt (.*$)
...
  1. Start/restart SuperCollider

OSX Users Note: you may see a security dialog disallowing the ugens to run. Please see this post by @oscd for workarounds/fixes

Synth Reference#

omi#

Description: todo

  • param
  • param
  • param

plaits#

Description: todo

  • param
  • param
  • param

braids#

Description: todo

  • param
  • param
  • param

Effects (Global)#

verb#

Description: todo

  • param
  • param
  • param

clouds#

Description: todo

  • param
  • param
  • param

etc#

Last updated on by Bernard Gray