Page 1 of 1

What is MetaModule?

Posted: Wed Aug 29, 2012 11:43 am
by NightRadio
There is the new MetaModule in SunVox v1.7.2. What is it?
With MetaModule you can create your own complex modules and save them in the .sunsynth file format.
In other words - you can include some external .sunvox song to your project and use this song as synth or effect.

How to use it?
1) Make a new song. Create some nice audio-chain with several modules. Generator + effects, or effects only. Test it. Then save to mysong.sunvox.
2) Clear all, make a new song again.
3) Add the MetaModule to your audio network.
4) Click the LOAD button under the MetaModule controllers. Then select mysong.sunvox from the first step.
5) And the important point: now this MetaModule contains your mysong.sunvox. Select some input module (controller 02) and you can play it, or use it as effect.
6) Save this MetaModule to mysynth.sunsynth file. And that's it. Your compex module is ready. You can use it in other projects. The mysynth.sunsynth file is similar to VST plugin.

Also you can optimize the 3th and 4th steps. Go to the menu of the window with modules. Click Load Module. Then select mysong.sunvox file. And MetaModule with your song will be created automatically.

Re: What is MetaModule?

Posted: Thu Aug 30, 2012 8:43 pm
by SolarLune
Thanks for that little tutorial, NightRadio. I was wondering, is there a way to trigger the MetaModule without actually playing a note from the source sunvox file? Or will it only play if it gets a note input?

Re: What is MetaModule?

Posted: Thu Aug 30, 2012 9:29 pm
by NightRadio
It plays when a note received only. No other ways in current version :)

Re: What is MetaModule?

Posted: Fri Aug 31, 2012 6:00 pm
by geckojsc
Maybe we should have a sub-forum for MetaModule instruments, beside the competitions forum?

Re: What is MetaModule?

Posted: Fri Aug 31, 2012 8:39 pm
by SolarLune
I think that might be a good idea. Or, we could just post our instruments in the Instruments section, but that wouldn't be very easy to maintain. Maybe with the sub-forum, each person can make a single, constantly updated thread for their instruments (so that it's easy to find instruments from each person)?

Re: What is MetaModule?

Posted: Fri Aug 31, 2012 9:07 pm
by geckojsc
Yeah, that's what I was thinking - that way each MetaModule released could get its own description, feedback, and news regarding updates, etc. And it would be easy to find them for newcomers too.

Re: What is MetaModule?

Posted: Fri Aug 31, 2012 10:45 pm
by NightRadio
No problem :)

Re: What is MetaModule?

Posted: Sat Sep 29, 2012 10:40 pm
by offthesky
hi there, thanks for posting this tutorial. btw, i can get the metamodule to work as an instrument no problem, but i've been trying to get the metamodule to also work simply as an effect... but with no such luck. the child .sunvox i've loaded into my metamodule simply has an echo effect in it, which i've set as the input of the parent metamodule. i've set the metamodule to play(param 3) and everything but when i play sounds through it, nothing goes through. am i missing a step?

Solved: after a bit of further experimentation, i think i figured it out - you have to set the input module to the "1st" module in the chain... it won't work if you set the input module to like the second or 3rd effect in the chain(of the child .sunvox project you're loading into the metamodule)... i had a generator running to the echo effect(making the echo effect the 2nd in the chain) which is why it didn't work... once i deleted the generator, it seemed to work okay as an effect... hope that helps others out there who might also run into this problem...

Re: What is MetaModule?

Posted: Tue Nov 20, 2012 11:01 pm
by marlow77
Hello all,

I am trying to figure out how to use some standard effects as modulation sources for the metamodules.

For instance--

Filter (with standard effect #22 "random controller value" in the pattern for two tracks of automation (1) Filter cutoff (2) Filter resonance) -->


If I attach a synth module before the filter I am good to go on using it as a metamodule.

METAMODULE (SYNTH -->FILTER with automation) -->OUT (This works!)

However I want to choose other synths to attach to this filter outside of the metamodule.

for instance-

SYNTH MODULE-->METAMODULE (FILTER with automation only) -->OUT (This doesn't work. :( )

Am I doing something wrong? I started the sub-song and attached to the only effect module in the metamodule (the filter effect module). Can it work this way? it would be so awesome to be able to automate the effects this way in the metamodules. Essentially, this could create limitless envelopes for tweaking input.

I dream of being able to either pitch the metamodule from an external synth (an arpeggio type of pitch system) or be able to use sample offset automation with live input... How cool would that be? Regardless, I am having lots of fun experimenting and Sunvox is such a beautiful engine in sight and sound.



Re: What is MetaModule?

Posted: Wed Nov 21, 2012 8:02 pm
by NightRadio
please check this example.
The scheme is: Generator -> Metamodule (Filter with automation pattern) -> OUT.
Key points:
  • "Play song" controller of Metamodule is ON;
  • In the second track of the main pattern you can see "C4 02", which means that i'm trying to play C4 note with Metamodule. Of course, Metamodule can't play this note, because it has no any generators, but he sees this note as a PLAY SONG command.

Re: What is MetaModule?

Posted: Thu Nov 22, 2012 5:53 am
by marlow77
Thanks, NightRadio! So exciting!!!

Is there a way to pitch a metamodule with a generator that I don't know about??

Seriously great stuff! I am going to making some metamodules to share. Planning on hyper-randomized goodness!

Thanks again,


Re: What is MetaModule?

Posted: Thu Nov 22, 2012 8:03 am
by NightRadio
Is there a way to pitch a metamodule with a generator that I don't know about??
Only one way to do this in the current version: use Generator with P.Modulation parameter in MetaModule. If you set P.Modulation, the pitch of Generator can be assigned by input audio signal of Generator. Check these files: examples/simple_examples/phase_modulation.sunvox and phase_modulation2.sunvox

Re: What is MetaModule?

Posted: Thu Feb 14, 2013 3:15 pm
by Darkhog
NR, please stick it, so when we have over 9000 metamodules instructions how to make one won't get lost.

Re: What is MetaModule--user-defined controls

Posted: Fri Jul 05, 2013 7:36 pm
by ccchips
Maybe a dumb question, but what are "user-defined" controls, and how do I define them?

Re: What is MetaModule?

Posted: Fri Jul 05, 2013 10:00 pm
by gilzad
Since a MetaModule can consist of several Generators and DSPs, you might want to offer access to some of their controllers.

Once you've loaded a song into a MetaModule, click on 'Controllers'. A dialog will open up and you'll see all the modules you've used inside that song.
Now you can select a controller in the left most column, which will be accessible on the outside (that is the user defined controller). The middle column will attach the selected controller to a module of the inner song. And the right most column will assign your user defined controller to an actual controller of the embedded module.

You can rename the user defined controller by changing the text above the 'Close' button of the Controller-dialog.

I hope this helped.