# Mutable Instruments UGens

**URL:** <https://uzu.lurk.org/t/mutable-instruments-ugens/2730>\
**Category:** TidalCycles\
**Tags:** questions\
**Created:** [10 January 2021 21:29 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730 "2021-01-10T21:29:57Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![chrislo](https://uzu.lurk.org/user_avatar/uzu.lurk.org/chrislo/32/1378_2.png) [@chrislo](https://uzu.lurk.org/u/chrislo)\
**Post date:** [10 January 2021 21:29 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/1 "2021-01-10T21:29:57Z")

</div>

Hi folks. I've been trying to regularly create something for Jamuary and today I decided to play with the various [ports of the Mutable Instruments eurorack modules to SuperCollider](https://github.com/v7b1/mi-UGens). I installed the UGens on my OS X machine (the pre-compiled binaries were not signed so I couldn't use them as-is, so I decided to compile them myself. The compilation instructions worked fine for me). Following @eris excellent tutorial I created a very basic wrapper for the Plaits UGen

```haskell
(
SynthDef(\plaits, {|out, sustain=1, pan, accelerate, freq, harm=0.5, timbre=0.5, morph=0.5, engine=0|
    var env = EnvGen.ar(Env.linen(0.01, 0.98, 0.01, 1,-3), timeScale:sustain, doneAction:2);
	var sound = MiPlaits.ar(pitch: freq.cpsmidi, engine: engine, harm: harm, timbre: timbre, morph: morph);
	Out.ar(out, DirtPan.ar(sound, ~dirt.numChannels, pan, env));
}).add
);

```

I'm using a simple envelope here just to get something working, but I think that could be improved (or I could rely on the envelope generator in Plaits instead).

And here's an example of how I used it in Tidalcycles:

```haskell
let harm = pF "harm"
let timbre = pF "timbre"
let morph = pF "morph"
let engine = pI "engine"

d1 $ slow 2 $ n "{0, 3 7 3 <0 7>}(5,8)" |-24 # sustain 0.1 # s "plaits" # engine (irand 15) # room 0.4 # gain 0.75

```

I recorded some of my jam, here I'm randomly modulating the synthesis "engine" that [Plaits](https://mutable-instruments.net/modules/plaits/) uses to create some glitchy effects. I recorded directly from SuperCollider.

https://w.soundcloud.com/player/?visual=false&url=https%3A%2F%2Fapi.soundcloud.com%2Ftracks%2F963145327&show_artwork=true&maxheight=166

Has anyone else played with these UGens in Tidal? I had a lot of fun running the various examples from the documentation in SuperCollider, and connecting different modules together. I might spend some time creating some wrappers for these UGens to use in Tidal. I think some of them, like `rings` might work as both "synths" and "effects" and I'm not quite sure what the best interface would be to allow them to be chained together.

---

<div class="post-metadata">

**Author:** ![Raph](https://uzu.lurk.org/user_avatar/uzu.lurk.org/raph/32/45_2.png) [@Raph](https://uzu.lurk.org/u/Raph)\
**Post date:** [10 January 2021 22:04 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/2 "2021-01-10T22:04:41Z")

</div>

I wasn't aware that there is a SuperCollider port of these modules! I'm really happy that you posted about it because these modules are excellent and more people might be encouraged to play with them. For those of you who haven't seen Mutable modules in action, I encourage you to take a look ([Plaits Module Demo](https://www.youtube.com/watch?v=_zYwdcYECdg)) ! It's really great to see that Émilie Gillet is open-sourcing all this.

I’ll try to follow your steps and compile them.

---

<div class="post-metadata">

**Author:** ![th4](https://uzu.lurk.org/user_avatar/uzu.lurk.org/th4/32/505_2.png) [@th4](https://uzu.lurk.org/u/th4)\
**Post date:** [11 January 2021 20:43 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/3 "2021-01-11T20:43:38Z")

</div>

Thanks for the reference!

I'm currently trying it, I was a bit confused by the installation instructions, so I'm putting more detailed steps here to save time for further noobs.

> Collect the UGen files from the build folders of the projects and put them together with the sc folder into your SC extensions folder.

For reference, on my Linux computer, the UGen files were the `.sc` files in the `mi-UGens/sc/Classes` folder, and the SC extensions folder was `~/.local/share/SuperCollider/Extensions/`.

---

<div class="post-metadata">

**Author:** ![Tomas\_Ciccola](https://uzu.lurk.org/user_avatar/uzu.lurk.org/tomas_ciccola/32/843_2.png) [@Tomas\_Ciccola](https://uzu.lurk.org/u/Tomas_Ciccola)\
**Post date:** [11 January 2021 21:48 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/4 "2021-01-11T21:48:19Z")

</div>

Heeyyy this are awesomee.  
Having so much fun with plaits and rings.  
The reverb also is super luuushh

---

<div class="post-metadata">

**Author:** ![chrislo](https://uzu.lurk.org/user_avatar/uzu.lurk.org/chrislo/32/1378_2.png) [@chrislo](https://uzu.lurk.org/u/chrislo)\
**Post date:** [11 January 2021 22:23 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/5 "2021-01-11T22:23:42Z")

</div>

That's really exciting - I'd love to hear what you all come up with and any ideas you have for interfaces between tidal and these ugens.

---

<div class="post-metadata">

**Author:** ![Tomas\_Ciccola](https://uzu.lurk.org/user_avatar/uzu.lurk.org/tomas_ciccola/32/843_2.png) [@Tomas\_Ciccola](https://uzu.lurk.org/u/Tomas_Ciccola)\
**Post date:** [11 January 2021 22:56 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/6 "2021-01-11T22:56:51Z")

</div>

Have you tried to use the clouds Ugen? I've tried it as a globalEffect and as an Insert type effect. The first method produced some results, but noting interesting, always sounds to low and rumbly. With the insert fx approach I won't get anything and SuperDirts prints "MiClouds \> numAudioIns: 2", which I don't know what it means (maybe clouds expects a signal array bigger? or smaller? I dunno...)

---

<div class="post-metadata">

**Author:** ![iii](https://uzu.lurk.org/letter_avatar_proxy/v4/letter/i/ecb155/32.png) [@iii](https://uzu.lurk.org/u/iii)\
**Post date:** [12 January 2021 13:04 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/7 "2021-01-12T13:04:18Z")

</div>

what does your directory structure look like?

(on Linux) after plenty of folder rearranging I keep getting:

```
exception in GraphDef_Recv: UGen 'MiPlaits' not installed.

```

after messing around with the MI clones on VCV Rack in the past, it would be really fun to use these in Tidal!

however I'm pretty clueless when it comes to SuperCollider and I'm evidently doing something wrong...

thanks!

---

<div class="post-metadata">

**Author:** ![th4](https://uzu.lurk.org/user_avatar/uzu.lurk.org/th4/32/505_2.png) [@th4](https://uzu.lurk.org/u/th4)\
**Post date:** [12 January 2021 17:35 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/8 "2021-01-12T17:35:38Z")

</div>

I don't understand which other informations about directory structure you need beside the paths I gave.

Here are the precise commands I typed to install the UGens:

```bash
git clone --recurse-submodules https://github.com/v7b1/mi-UGens.git
git clone https://github.com/supercollider/supercollider
cd mi-UGens/
./linux-build.sh /tmp/supercollider/
cp sc/Classes/* ~/.local/share/SuperCollider/Extensions/

```

If your issue is with locating the equivalent of `~/.local/share/SuperCollider/Extensions`, try starting an instance of SuperCollider and looking up which directories appear at the very beginning of the log. For me it's:

```haskell
compiling class library...
	Found 862 primitives.
	Compiling directory '/usr/share/SuperCollider/SCClassLibrary'
	Compiling directory '/usr/share/SuperCollider/Extensions'
	Compiling directory '~/.local/share/SuperCollider/Extensions'
	Compiling directory '~/.local/share/SuperCollider/downloaded-quarks/Vowel'
	Compiling directory '~/.local/share/SuperCollider/downloaded-quarks/Dirt-Samples'
	Compiling directory '~/.local/share/SuperCollider/downloaded-quarks/SuperDirt'
	numentries = 1223511 / 19201236 = 0.064
	5919 method selectors, 3244 classes
	method table size 20136680 bytes, big table size 153609888
	Number of Symbols 15060
	Byte Code Size 431257
	compiled 485 files in 1.59 seconds

```

---

<div class="post-metadata">

**Author:** ![iii](https://uzu.lurk.org/letter_avatar_proxy/v4/letter/i/ecb155/32.png) [@iii](https://uzu.lurk.org/u/iii)\
**Post date:** [12 January 2021 18:40 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/9 "2021-01-12T18:40:46Z")

</div>

interesting - I thought maybe the .sc files had to be in their own folder in Extensions (hence why I was asking about directory structure) however I've already tried the steps that you've described (twice to be sure!) and I still get the same error.

thank you anyway @th4

🙂

---

<div class="post-metadata">

**Author:** ![ndr\_brt](https://uzu.lurk.org/user_avatar/uzu.lurk.org/ndr_brt/32/396_2.png) [@ndr\_brt](https://uzu.lurk.org/u/ndr_brt)\
**Post date:** [12 January 2021 22:24 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/10 "2021-01-12T22:24:05Z")

</div>

I had the same issue... I resolved copying the `.so` files as reported in the guide:

> Collect the UGen files from the build folders of the projects and put them together with the sc folder into your SC extensions folder.

I did it with this command:  
`cp **/build/*.so ~/.local/share/SuperCollider/Extensions`

---

<div class="post-metadata">

**Author:** ![iii](https://uzu.lurk.org/letter_avatar_proxy/v4/letter/i/ecb155/32.png) [@iii](https://uzu.lurk.org/u/iii)\
**Post date:** [13 January 2021 04:52 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/11 "2021-01-13T04:52:52Z")

</div>

this was it! apparently I am incapable of following instructions.

thanks both of you

---

<div class="post-metadata">

**Author:** ![ndr\_brt](https://uzu.lurk.org/user_avatar/uzu.lurk.org/ndr_brt/32/396_2.png) [@ndr\_brt](https://uzu.lurk.org/u/ndr_brt)\
**Post date:** [13 January 2021 09:35 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/12 "2021-01-13T09:35:19Z")

</div>

Hey, I'm not able to define an effect with any of those (tried with clouds and verb).

I define the effect this way:

```haskell
(
~dirt.addModule('verb', { |dirtEvent|
	dirtEvent.sendSynth('verb' ++ ~dirt.numChannels,
		[
      vwet: ~vwet,
			vtime: ~vtime,
			vdamp: ~vdamp,
			vhp: ~vhp,
			vfreeze: ~vfreeze,
			vdiff: ~vdiff,
		]
	)
}, {~vwet.notNil});

SynthDef("verb" ++ ~dirt.numChannels, { |out, vwet=0.5, vtime=0.7, vdamp=0.5, vhp=0.05, vfreeze=0, vdiff=0.625|
	var signal = In.ar(out, ~dirt.numChannels);
	signal = MiVerb.ar(signal, vwet, vtime, vdamp, vhp, vfreeze, vdiff);
  ReplaceOut.ar(out, signal)
}).add;

);

```

I also configured the parameters on tidal like:

```haskell
let vwet = pF "vwet"
    vtime = pF "vtime"
    vdamp = pF "vdamp"
    vhp = pF "vhp"
    vfreeze = pI "vfreeze"
    vdiff = pF "vdiff"

```

there's something I'm missing?

---

<div class="post-metadata">

**Author:** ![th4](https://uzu.lurk.org/user_avatar/uzu.lurk.org/th4/32/505_2.png) [@th4](https://uzu.lurk.org/u/th4)\
**Post date:** [13 January 2021 11:57 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/13 "2021-01-13T11:57:33Z")

</div>

I had actually copied the `.so` files before, which didn't work for me, so I'm postulating that both the `.scd` and the `.so` are needed.

---

<div class="post-metadata">

**Author:** ![sherwood](https://uzu.lurk.org/user_avatar/uzu.lurk.org/sherwood/32/1188_2.png) [@sherwood](https://uzu.lurk.org/u/sherwood)\
**Post date:** [15 January 2021 08:33 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/14 "2021-01-15T08:33:53Z")

</div>

Looks like you forgot to add "out" when adding the module to dirt (right after vdiff: ~vdiff). This works for me:

```
(
~dirt.addModule('verb', { |dirtEvent|
	dirtEvent.sendSynth('verb' ++ ~dirt.numChannels,
		[
			vwet: ~vwet,
			vtime: ~vtime,
			vdamp: ~vdamp,
			vhp: ~vhp,
			vfreeze: ~vfreeze,
			vdiff: ~vdiff,
			out: ~out
		]
	)
}, {~vwet.notNil});
)

~dirt.modules;

(
SynthDef("verb" ++ ~dirt.numChannels, { |out, vwet=0.5, vtime=0.7, vdamp=0.5, vhp=0.05, vfreeze=0, vdiff=0.625|
	var signal = In.ar(out, ~dirt.numChannels);
	signal = MiVerb.ar(signal, vwet, vtime, vdamp, vhp, vfreeze, vdiff);
  ReplaceOut.ar(out, signal)
}).add;

);
```

---

<div class="post-metadata">

**Author:** ![ndr\_brt](https://uzu.lurk.org/user_avatar/uzu.lurk.org/ndr_brt/32/396_2.png) [@ndr\_brt](https://uzu.lurk.org/u/ndr_brt)\
**Post date:** [15 January 2021 09:25 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/15 "2021-01-15T09:25:31Z")

</div>

thank you, it works! but I think they'll work better as global effects, will try that soon

---

<div class="post-metadata">

**Author:** ![sherwood](https://uzu.lurk.org/user_avatar/uzu.lurk.org/sherwood/32/1188_2.png) [@sherwood](https://uzu.lurk.org/u/sherwood)\
**Post date:** [15 January 2021 09:58 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/16 "2021-01-15T09:58:18Z")

</div>

Great! Share with us your results.

---

<div class="post-metadata">

**Author:** ![Raph](https://uzu.lurk.org/user_avatar/uzu.lurk.org/raph/32/45_2.png) [@Raph](https://uzu.lurk.org/u/Raph)\
**Post date:** [15 January 2021 11:08 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/17 "2021-01-15T11:08:55Z")

</div>

> [@sherwood](#):
>
> Share with us your results.

Does anyone want to start a collective effort for writing SuperDirt bindings for Mutable UGens? I believe that it would be a great addition to Tidal, some as instruments and others as Global Effects. It would be nice to have an efficient and easy way to install them and connect them to Tidal.

---

<div class="post-metadata">

**Author:** ![sherwood](https://uzu.lurk.org/user_avatar/uzu.lurk.org/sherwood/32/1188_2.png) [@sherwood](https://uzu.lurk.org/u/sherwood)\
**Post date:** [15 January 2021 11:16 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/18 "2021-01-15T11:16:36Z")

</div>

Rings is working nicely!

In Tidal:

```haskell
let ringsfreq = pF "rfreq"
let ringsstruct = pF "rstruct"
let ringsbright = pF "rbright"
let ringsdamp = pF "rdamp"
let ringspos = pF "rpos"
let ringsmodel = pI "rmodel"
let ringsintern_exciter = pI "rintern_exciter"
let ringstrig = pI "rtrig"
let ringseasteregg = pI "reasteregg"
let ringsbypass= pI "rbypass"

```

Then is SC:

```haskell
(
~dirt.addModule('rings', { |dirtEvent|
	dirtEvent.sendSynth('rings' ++ ~dirt.numChannels,
		[
			rtrig: ~rtrig,
			rfreq: ~rfreq,
			rstruct: ~rstruct,
			rbright: ~rbright,
			rdamp: ~rdamp,
			rpos: ~rpos,
			rmodel: ~rmodel,
			rpoly: ~rpoly,
			rintern_exciter: ~rintern_exciter,
			reasteregg: ~reasteregg,
			rbypass: ~rbypass,
			out: ~out
		]
	)
}, {~rbright.notNil});
)

(
SynthDef("rings" ++ ~dirt.numChannels, { |out, rtrig=0, rfreq=60.0, rstruct=0.75, rbright=0.75, rdamp=0.4, rpos=0.9, rmodel=0, rpoly=1,rintern_exciter=0, reasteregg=0, rbypass=0|
	var signal = In.ar(out, ~dirt.numChannels);
	signal = MiRings.ar(signal, rtrig, rfreq, rstruct, rbright, rdamp, rpos, rmodel, rpoly,rintern_exciter, reasteregg, rbypass);
  ReplaceOut.ar(out, signal)
}).add;

);

```

Use in Tidal:

```haskell
d1 $ s "sn*16" # ringsbright tri # ringsfreq 30 # slow 2 (ringspos saw) # ringsmodel 0 # ringsstruct 0.75 # ringsdamp 0.4

```

---

<div class="post-metadata">

**Author:** ![sherwood](https://uzu.lurk.org/user_avatar/uzu.lurk.org/sherwood/32/1188_2.png) [@sherwood](https://uzu.lurk.org/u/sherwood)\
**Post date:** [15 January 2021 11:17 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/19 "2021-01-15T11:17:49Z")

</div>

Sure, I'm in for being part of the collective.

---

<div class="post-metadata">

**Author:** ![sherwood](https://uzu.lurk.org/user_avatar/uzu.lurk.org/sherwood/32/1188_2.png) [@sherwood](https://uzu.lurk.org/u/sherwood)\
**Post date:** [15 January 2021 11:42 UTC](https://uzu.lurk.org/t/mutable-instruments-ugens/2730/20 "2021-01-15T11:42:30Z")

</div>

Set both the ringstrig and ringsinternal\_exciter to 1 to use the internal exciter. It will combine with whatever sample sound is being sent in:

```haskell
d2 $ s "hh*16" # ringsbright perlin # ringsfreq 30 # slow 2 (ringspos saw) # ringsmodel (irand 4) # ringsstruct 0.75 # ringsdamp 0.4 # ringseasteregg 0 # ringstrig 1 # ringsintern_exciter 1 # ringsbypass 0 # gain (range 0.9 1.5 rand) 

```

Having too much fun with this. Plaits and rings:

```haskell
--plaits
d1 $ slow 0.5 $ n "[0*8, 0(3,8)]" |-18 
# sustain 0.1 
# s "plaits" 
# engine 6 
# room 0.7 
# gain 0.75 
# harm (range 0.8 1.0 $ perlin) 
# timbre (range 0.45 0.5 $ perlin) 
# slow 8 (morph (range 1.0 0.9 $ square)) 

-- rings
d2 $ sometimesBy 0.4 (# ringseasteregg 1) 
$ sometimesBy 0.7 (# ringsbypass 1) 
$ s "hh*16" 
# ringsbright perlin 
# ringsfreq 30 
# slow 2 (ringspos saw) 
# slow 2 (ringsmodel (run 4)) 
# ringsstruct 0.75 
# ringsdamp 0.4 
# ringstrig 1 
# gain (range 0.9 1.5 rand)

```

[Next page](https://uzu.lurk.org/t/mutable-instruments-ugens/2730.md?page=2)