Skip to content
Branch: master-dev
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
README.md
minimal.soul
poly-dsp-effect.soul
poly-dsp.soul

README.md

faust2soul

faust2soul tool compiles a Faust DSP program to SOUL source code as a monophonic DSP or possibly a MIDI controllable polyphonic one (when the DSP describes an instrument, following the freq, gain, gate parameter naming convention). The resulting SOUL code can be played using the 'soul' runtime (only available for early developers for now, ask Cesare or Jules...), or by pasting and compiling the code in the SOUL Playground:

faust2soul [-nvoices <num>] [-effect auto|<effect.dsp>] [-midi] [-play] [additional Faust options (-vec -vs 8...)] <file.dsp>

Here are the available options:

  • -nvoices <num> to produce a polyphonic self-contained DSP with <num> voices, ready to be used with MIDI
  • -effect <effect.dsp> to produce a polyphonic DSP connected to a global output effect, ready to be used with MIDI
  • -effect auto to produce a polyphonic DSP connected to a global output effect defined as 'effect' in <file.dsp>, ready to be used with MIDI
  • -midi to activate MIDI control
  • -play to start the 'soul' runtime with the generated SOUL file

So for instance:

  • faust2soul noise.dsp to produce a noise.soul file
  • faust2soul -play osc.dsp to produce an osc.soul file and play it
  • faust2soul -midi -nvoices 16 -play clarinetMIDI.dsp to produce a 16 voices polyphonic MIDI aware intrument as a clarinetMIDI.soul file and play it
  • faust2soul -midi -nvoices 16 -effect freeverb.dsp -play violinMIDI.dsp to produce a 16 voices polyphonic MIDI aware intrument with a global effect as a violinMIDI.soul file and play it
You can’t perform that action at this time.