Kodamo EssenceFM: MIDI CC, NRPN and OSC map¶
The Kodamo EssenceFM as named OSC addresses — 29 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Kodamo EssenceFM |
|---|---|
| Vendor | Kodamo |
| OSC prefix | /essencefm |
| Source | 📦 Derived from MIDI Guide (community CC/NRPN data) |
| Firmware | unknown |
| Revision | per pencilresearch canonical CSV |
| Upstream | pencilresearch |
| Data licence | CC-BY-SA-4.0 — MIDI Guide (https://midi.guide) by Pencil Research and contributors |
| Driver file | devices/kodamo/essencefm.json |
Not tested on the device yet
This driver comes from documentation or community data and has not been checked on real hardware. If you own one, a quick test and a pull request promoting it helps everyone — see CONTRIBUTING.
How do you control 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 devices/kodamo/essencefm.json --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 essencefm: ask “what can the Kodamo EssenceFM do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (30)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/essencefm/msb_bank |
continuous | ||||
/essencefm/lsb_bank |
32 | 0–127 | continuous | ||
/essencefm/mod |
1 | 0–127 | continuous | ||
/essencefm/porta |
5 | 0–127 | continuous | ||
/essencefm/vol |
7 | 0–127 | continuous | ||
/essencefm/bal |
8 | 0–127 | continuous | ||
/essencefm/pan |
10 | 0–127 | continuous | ||
/essencefm/expr |
11 | 0–127 | continuous | ||
/essencefm/fx1_type |
47 | 0–127 | continuous | ||
/essencefm/fx2_type |
48 | 0–127 | continuous | ||
/essencefm/fx1_ctrl1 |
51 | 0–127 | continuous | ||
/essencefm/fx1_ctrl2 |
52 | 0–127 | continuous | ||
/essencefm/fx1_ctrl3 |
53 | 0–127 | continuous | ||
/essencefm/fx1_ctrl4 |
54 | 0–127 | continuous | ||
/essencefm/fx1_ctrl5 |
55 | 0–127 | continuous | ||
/essencefm/fx2_ctrl1 |
56 | 0–127 | continuous | ||
/essencefm/fx2_ctrl2 |
57 | 0–127 | continuous | ||
/essencefm/fx2_ctrl3 |
58 | 0–127 | continuous | ||
/essencefm/fx2_ctrl4 |
59 | 0–127 | continuous | ||
/essencefm/fx2_ctrl5 |
60 | 0–127 | continuous | ||
/essencefm/fx1_lvl |
61 | 0–127 | continuous | ||
/essencefm/fx2_lvl |
62 | 0–127 | continuous | ||
/essencefm/sustain |
64 | 0–127 | continuous | ||
/essencefm/dry_lvl |
90 | 0–127 | continuous | ||
/essencefm/fx1_send |
91 | 0–127 | continuous | ||
/essencefm/fx_rout_mod |
92 | 0–127 | continuous | ||
/essencefm/fx2_send |
93 | 0–127 | continuous | ||
/essencefm/note_off |
120 | 0–127 | continuous | ||
/essencefm/mono_mod |
126 | 0–127 | continuous | ||
/essencefm/poly_mod |
127 | 0–127 | continuous |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /essencefm/note/on <note> <velocity>, /essencefm/cc/<number> <value>, /essencefm/pitchbend <0-16383>, /essencefm/program_change <n>.
Limitations¶
CC/NRPN only. SysEx (preset management, display control, bulk dump/load, vendor-proprietary opcodes) is NOT covered by pencilresearch. To extend this device with SysEx, sniff the vendor editor, add `sysex.header/footer` + `commands` blocks, and use `update_device.md` PR template.