# Swarmora

> Coupled oscillators that pull into tune: a detuned swarm of sines per note that pull draws into one pitched tone and chaos breaks into rough motion.

- Instrument id: `org.sournd.instrument.swarmora`
- Kind: instrument (a synth you play with notes, keys or MIDI)
- Voices: 8 voices
- Tier: Free
- Version: 0.1.0
- Price: free: a closed library, free to use in your plugins, downloaded with no account or email

## Get it

Download it with no account or email: https://sournd.com/download/free/macos (macOS universal) or https://sournd.com/download/free/linux (Linux x86_64 and aarch64). One archive with every free engine and synth: static library, C headers, README. An AI agent can fetch the links with the MCP tool `get_free_download` at https://sournd.com/mcp.

## Parameters

| Id | Key | Name | Min | Max | Default | Unit |
|---|---|---|---|---|---|---|
| 0 | `pull` | Pull | 0 | 100 | 70 | % |
| 1 | `scatter` | Scatter | 0 | 100 | 30 | cents |
| 2 | `chaos` | Chaos | 0 | 100 | 0 | % |
| 3 | `size` | Swarm size | 4 | 12 | 8 | oscillators |
| 4 | `ratio_set` | Ratio set | 0 | 3 | 0 | - |
| 5 | `kick` | Kick | 0 | 100 | 40 | % |
| 6 | `brightness` | Operator brightness | 0 | 100 | 0 | % |
| 7 | `gather` | Gather | 1 | 8000 | 400 | ms |
| 8 | `tone` | Tone | 200 | 18000 | 6000 | Hz |
| 9 | `glow` | Lock to tone | 0 | 100 | 30 | % |
| 10 | `attack` | Attack | 1 | 10000 | 30 | ms |
| 11 | `decay` | Decay | 5 | 20000 | 800 | ms |
| 12 | `sustain` | Sustain | 0 | 100 | 80 | % |
| 13 | `release` | Release | 5 | 10000 | 900 | ms |
| 14 | `width` | Width | 0 | 100 | 60 | % |
| 15 | `pressure_pull` | Pressure to pull | 0 | 100 | 0 | % |

## Play it from code

Instruments use the same C ABI as effects, plus note input: `sournd_engine_note_on(e, note, velocity, sample_offset)`, `sournd_engine_note_off(e, note, sample_offset)` and `sournd_engine_all_notes_off(e)`. In JUCE, the bridge feeds your `MidiBuffer` straight in. See the [C ABI reference](https://sournd.com/docs/abi/index.md).