SweejTech Docs

Quick Start ​

Essential Setup ​

  1. Connect MIDI Device:

    • Connect your MIDI controller via USB before starting the editor
    • The plugin automatically detects connected devices

  2. Configure MIDI Settings:

    • Go to Edit → Project Settings → SweejTech MetaSound MIDI
    • Enable your MIDI device from the list
    • Optionally enable Log MIDI Messages for debugging

  3. Test Connection:

    • With logging enabled, press keys or turn knobs on your controller
    • Verify messages appear in the Output Log

Creating a MIDI-Controlled MetaSound ​

  1. Create a Basic MetaSound:

    • In Content Browser: Add New → Sounds → MetaSound
    • Add a basic sound source (e.g., Wave Player or oscillator)

  2. Add MIDI Simple Interface:

    • In MetaSound editor: Right-click → Add Interface
    • Select SweejTech → MIDI Simple
    • Connect Note On output to your sound's trigger input
    • Press keys on your MIDI controller to trigger the sound

  3. Add Control Change for Parameters:

    • Add SweejTech MIDI Control Change interface
    • Add SweejTech MIDI Map Control Change patch
    • Connect On Update and Values outputs to the patch
    • Set Index to the controller number (e.g., 7 for volume)
    • Connect the mapped value to a parameter (e.g., volume)

Advanced Features ​

  1. Add Voices Interface for Polyphony:

    • Add SweejTech MIDI Voices interface for multiple simultaneous notes
    • Configure voice count in project settings (1-32)
    • Use NoteNumberValues for pitch mapping

  2. Add Pitch Bend Interface:

    • Add SweejTech MIDI Pitch Bend interface
    • Use Scaled output (-1.0 to 1.0) for easier mapping
    • Multiply by range value (e.g., 2.0 for ±2 semitones)

Debugging ​

  1. Use the MIDI Logger:
    • Enable Log MIDI Messages in project settings
    • The Output Log will show all incoming MIDI events
    • Use this to identify CC numbers for your controller's knobs