devices/arturia/microfreak.vendor.fw-microfreak-tools-0.1.0.json, updated 2026-10-26Edit on GitHubJSONCSVMIDNAMOSCQueryArturia MicroFreak running microfreak-tools 0.1.0 plugins
The Arturia MicroFreak MIDI implementation: 21 CC, each named, for Claude (MCP), SuperCollider or any OSC app.
- sourcemaker's documentation
- firmwaremicrofreak-tools-0.1.0
- licenceApache-2.0
- Maker
- Arturia
- Firmware
- microfreak-tools 0.1.0 plugins (by gbryant)
- Source
- maker's documentation
- Licence
- Apache-2.0
From the README of gbryant/microfreak-tools at 396fcf4, licence Apache-2.0.
microfreak-tools
Command-line tools for the Arturia MicroFreak. Read and write presets, samples, wavetables and settings over MIDI, and patch and flash firmware. Plugins add custom firmware and the commands that use it, such as putting your own words on the Speech engine.
Not affiliated with, authorised by or endorsed by Arturia. No Arturia code or binaries are in this repository. Commands that need firmware take the path to an image you already own.
Install
uv tool install microfreak-tools # puts `mfreak` on PATH
With the plugins, add a --with for each:
uv tool install microfreak-tools --with mfreak-speech --with mfreak-peek
To upgrade, uv tool upgrade microfreak-tools. With pipx, pipx install
microfreak-tools, then pipx inject microfreak-tools mfreak-speech for each
plugin.
From a clone, uv run mfreak doctor runs it without installing, with both
plugins.
Reading audio files needs ffmpeg (brew install ffmpeg). Recording and USB
support come with the package; on Linux, recording also needs the system
libportaudio2. mfreak doctor reports anything missing.
Use of this device
In the last 30 days: calls from agents aimed at it, counted since 2026-11-18.
Communities
MIDI controls
21 controls, from the source at microfreak-tools 0.1.0 plugins (by gbryant)
General
| Control | CC | Range | Name to send |
|---|---|---|---|
| Glide | 5 | 0–127 | /microfreak_tools/general/glide |
Oscillator
| Control | CC | Range | Name to send |
|---|---|---|---|
| Type | 9 | 0–127 | /microfreak_tools/oscillator/type |
| Wave | 10 | 0–127 | /microfreak_tools/oscillator/wave |
| Timbre | 12 | 0–127 | /microfreak_tools/oscillator/timbre |
| Shape | 13 | 0–127 | /microfreak_tools/oscillator/shape |
Filter
| Control | CC | Range | Name to send |
|---|---|---|---|
| Cutoff | 23 | 0–127 | /microfreak_tools/filter/cutoff |
| Resonance | 83 | 0–127 | /microfreak_tools/filter/resonance |
Cycling envelope
| Control | CC | Range | Name to send |
|---|---|---|---|
| Cycling env rise | 102 | 0–127 | /microfreak_tools/cycling_envelope/cycling_env_rise |
| Cycling env fall | 103 | 0–127 | /microfreak_tools/cycling_envelope/cycling_env_fall |
| Cycling env hold | 28 | 0–127 | /microfreak_tools/cycling_envelope/cycling_env_hold |
| Cycling env amount | 24 | 0–127 | /microfreak_tools/cycling_envelope/cycling_env_amount |
Arpeggiator/sequencer
| Control | CC | Range | Name to send |
|---|---|---|---|
| Arpeggiator sequencer arp seq rate free | 91 | 0–127 | /microfreak_tools/arpeggiator_sequencer/arp_seq_rate_free |
| Arpeggiator sequencer arp seq rate sync | 92 | 0–127 | /microfreak_tools/arpeggiator_sequencer/arp_seq_rate_sync |
LFO
| Control | CC | Range | Name to send |
|---|---|---|---|
| Rate free | 93 | 0–127 | /microfreak_tools/lfo/rate_free |
| Rate sync | 94 | 0–127 | /microfreak_tools/lfo/rate_sync |
Envelope
| Control | CC | Range | Name to send |
|---|---|---|---|
| Attack | 105 | 0–127 | /microfreak_tools/envelope/attack |
| Decay | 106 | 0–127 | /microfreak_tools/envelope/decay |
| Sustain | 29 | 0–127 | /microfreak_tools/envelope/sustain |
| Filter amount | 26 | 0–127 | /microfreak_tools/envelope/filter_amount |
Keyboard
| Control | CC | Range | Name to send |
|---|---|---|---|
| Hold button toggle | 64 | 0–127 | /microfreak_tools/keyboard/hold_button_toggle |
| Spice | 2 | 0–127 | /microfreak_tools/keyboard/spice |
Performance MIDI
Notes, pitch bend and any CC are also available: /microfreak_tools/note/on <note> <velocity>, /microfreak_tools/cc/<number> <value>, /microfreak_tools/pitchbend <0-16383>, /microfreak_tools/program_change <n>.
The same MIDI as microfreak, which this firmware shares.
Use it
Find the MIDI ports, then start the bridge with this driver:
osc-bridge detect # prints the ready-to-run line for what is plugged in
osc-bridge run --device arturia/microfreak.vendor.fw-microfreak-tools-0.1.0 --out-port <N> --in-port <M>
Then send OSC to 127.0.0.1:7777, for example:
From Claude or any MCP client, the osc-bridge mcp server exposes this driver as microfreak_tools: ask “what can the Arturia MicroFreak do?” and it reads this map with list_routes. See the MCP guide.
How it is recognised
- The Arturia MicroFreak answers the MIDI Identity Request (
F0 7E 7F 06 01 F7) withF0 7E ·· 06 02 00 20 6B 06 00 06 01 …. - Its firmware version is in bytes 12, 13, 14, 15 of the answer (each byte as a number).
- Its USB MIDI port names hold “MicroFreak”.
osc-bridge detect sends these and picks this driver when they match.
Programs and banks
A program change selects a sound.
| Bank | Bank select (CC 0 / CC 32) | Program change | Numbers | Shown as |
|---|---|---|---|---|
| 001-128 | 0 / – | 0–127 | 1–128 | 001-128 |
| 129-256 | 1 / – | 0–127 | 129–256 | 129-256 |
| 257-384 | 2 / – | 0–127 | 257–384 | 257-384 |
| 385-512 | 3 / – | 0–127 | 385–512 | 385-512 |
Recall one with /microfreak_tools/program/recall <bank> <number> (the bank by name, the number as shown).
Reading a stored sound back: a request names the stored program.
512 presets (1-512, user 129-512 since firmware 5.0): CC 0 = (preset - 1) / 128, then program change (preset - 1) mod 128, on channel 1; it changes the active sound only (ManageFreak docs/PROTOCOLLO.md and freakout microfreak_midi.py select_preset, both checked on the device). Presets read by Arturia SysEx F0 00 20 6B 07 01 \<seq> ..., operation 19h per preset 0-511 (Elektroid).
Limitations
microfreak-tools 0.1.0 by gbryant (Apache-2.0): preset, sample and wavetable transfer over SysEx/USB, and plugins that patch the firmware (mfreak-speech: a custom Speech-engine vocabulary; mfreak-peek). The MIDI chart is unchanged. Untested on hardware.
Firmwares
The Arturia MicroFreak runs 5 firmwares SynthHub maps, each with its own MIDI or another's it shares. All the devices with several: firmwares.
| Firmware | From | Licence | MIDI | Sounds |
|---|---|---|---|---|
| freakpatch 0.3.0, Release + matrix build | github.com/ThisFreakDoesntExist | its own | ||
| freakpatch 0.3.0, Release build | github.com/ThisFreakDoesntExist | its own | ||
| FreakSwap 8705fc3 | github.com/doriamxyz | same as arturia/microfreak | ||
| microfreak-tools 0.1.0 plugins | github.com/gbryant | Apache-2.0 | same as arturia/microfreak | |
| SuperFreaker 0.1.2 | freakierfirmware.com | its own |
Other sources
The Arturia MicroFreak is mapped in 6 versions. per pencilresearch canonical CSV.
Frequently asked questions
Which MIDI CC controls the filter cutoff on the Arturia MicroFreak?
CC 23 (0–127), named /microfreak_tools/filter/cutoff in SynthHub's map.
How many parameters of the Arturia MicroFreak can be controlled over MIDI?
SynthHub's map of the Arturia MicroFreak lists 21 MIDI CC parameters, each with its number, range and a readable name; the full chart is on this page.
Can an AI agent like Claude control the Arturia MicroFreak?
Yes: SynthHub's hosted MCP server knows the Arturia MicroFreak's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.