Mutable Instruments Yarns: MIDI CC, NRPN and OSC map¶
The Mutable Instruments Yarns as named OSC addresses — 154 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Mutable Instruments Yarns |
|---|---|
| Vendor | Mutable Instruments |
| OSC prefix | /yarns |
| 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/mutable-instruments/yarns.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/mutable-instruments/yarns.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 yarns: ask “what can the Mutable Instruments Yarns do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (154)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/yarns/part_channel/vibrato |
1 | 0–127 | continuous | Part channel | |
/yarns/part_channel/aux_cv_1 |
2 | 0–127 | continuous | Part channel | |
/yarns/part_channel/aux_cv_2 |
4 | 0–127 | continuous | Part channel | |
/yarns/part_channel/glide_time |
5 | 0–127 | continuous | Part channel | |
/yarns/part_channel/lower_note_n |
16 | 0–127 | continuous | Part channel | |
/yarns/part_channel/upper_note_n |
17 | 0–127 | continuous | Part channel | |
/yarns/part_channel/voicing_vo |
18 | 0–127 | continuous | Part channel | |
/yarns/part_channel/note_priority_np |
19 | 0–127 | continuous | Part channel | |
/yarns/part_channel/legato_mode_lg |
20 | 0–127 | continuous | Part channel | |
/yarns/part_channel/pitch_bend_range_br |
21 | 0–127 | continuous | Part channel | |
/yarns/part_channel/vibrato_range_vr |
22 | 0–127 | continuous | Part channel | |
/yarns/part_channel/vibrato_speed_vs |
23 | 0–127 | continuous | Part channel | |
/yarns/part_channel/transpose_tt |
24 | 0–127 | continuous | Part channel | |
/yarns/part_channel/fine_tuning_tf |
25 | 0–127 | continuous | Part channel | |
/yarns/part_channel/tuning_root_tr |
26 | 0–127 | continuous | Part channel | |
/yarns/part_channel/tuning_system_ts |
27 | 0–127 | continuous | Part channel | |
/yarns/part_channel/trigger_duration_t |
28 | 0–127 | continuous | Part channel | |
/yarns/part_channel/trigger_velocity_scale_t |
29 | 0–127 | continuous | Part channel | |
/yarns/part_channel/trigger_shape_t |
30 | 0–127 | continuous | Part channel | |
/yarns/part_channel/aux_cv_out_cv_3 |
31 | 0–127 | continuous | Part channel | |
/yarns/part_channel/oscillator_waveform_os |
71 | 0–127 | continuous | Part channel | |
/yarns/part_channel/aux_cv_out_4 |
72 | 0–127 | continuous | Part channel | |
/yarns/part_channel/tuning_factor_t |
73 | 0–127 | continuous | Part channel | |
/yarns/part_channel/arp_seq_clock_division_c |
102 | 0–127 | continuous | Part channel | |
/yarns/part_channel/arp_seq_gate_length_g |
103 | 0–127 | continuous | Part channel | |
/yarns/part_channel/arp_range_ar |
104 | 0–127 | continuous | Part channel | |
/yarns/part_channel/arp_direction_ad_rg |
105 | 0–127 | continuous | Part channel | |
/yarns/part_channel/arp_pattern_ap_rp |
106 | 0–127 | continuous | Part channel | |
/yarns/part_channel/euclidean_length_e |
107 | 0–127 | continuous | Part channel | |
/yarns/part_channel/euclidean_fill_ef |
108 | 0–127 | continuous | Part channel | |
/yarns/part_channel/euclidean_rotate_er |
109 | 0–127 | continuous | Part channel | |
/yarns/part_channel/record_tie |
112 | 0–127 | continuous | Part channel | |
/yarns/part_channel/record_reset |
113 | 0–127 | continuous | Part channel | |
/yarns/rc_channel_global/layout |
1 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/tempo |
2 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/swing |
3 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/input_clock_division_i |
33 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/output_clock_division_o |
34 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/bar_duration_b |
35 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/nudge_first_tick_nu |
65 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/clock_manual_start_ms |
66 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_global/clock_output_c |
67 | 0–127 | continuous | RC channel: Global | |
/yarns/rc_channel_part_1/part_1_midi_channel_ch |
4 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_lower_note_n |
5 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_upper_note_n |
6 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_midi_out_mode |
7 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_voicing_vo |
8 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_note_priority_np |
9 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_portamento_po |
10 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_legato_mode_lg |
11 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_pitch_bend_range_br |
12 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_vibrato_range_vr |
13 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_vibrato_speed_vs |
14 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_transpose_tt |
15 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_fine_tuning_tf |
16 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_tuning_root_tr |
17 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_tuning_system_ts |
18 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_trigger_duration_t |
19 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_velocity_scale_t |
20 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_trigger_shape_t |
21 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_aux_cv_out_cv_3 |
22 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_oscillator_shape_os |
23 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_arp_seq_clock_division_c |
24 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_arp_seq_gate_length_g |
25 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_arp_range_ar_rg |
26 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_arp_direction_ad |
27 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_arp_pattern_ap_rp |
28 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_euclidean_length_e |
29 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_euclidean_fill_ef |
30 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_1/part_1_euclidean_rotate_er |
31 | 0–127 | continuous | RC channel: Part 1 | |
/yarns/rc_channel_part_2/part_2_midi_channel_ch |
36 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_lower_note_n |
37 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_upper_note_n |
38 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_midi_out_mode |
39 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_voicing_vo |
40 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_note_priority_np |
41 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_portamento_po |
42 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_legato_mode_lg |
43 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_pitch_bend_range_br |
44 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_vibrato_range_vr |
45 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_vibrato_speed_vs |
46 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_transpose_tt |
47 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_fine_tuning_tf |
48 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_tuning_root_tr |
49 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_tuning_system_ts |
50 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_trigger_duration_t |
51 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_velocity_scale_t |
52 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_trigger_shape_t |
53 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_aux_cv_out_cv_3 |
54 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_oscillator_shape_os |
55 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_arp_seq_clock_division_c |
56 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_arp_seq_gate_length_g |
57 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_arp_range_ar_rg |
58 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_arp_direction_ad |
59 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_arp_pattern_ap_rp |
60 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_euclidean_length_e |
61 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_euclidean_fill_ef |
62 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_2/part_2_euclidean_rotate_er |
63 | 0–127 | continuous | RC channel: Part 2 | |
/yarns/rc_channel_part_3/part_3_midi_channel_ch |
68 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_lower_note_n |
69 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_upper_note_n |
70 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_midi_out_mode |
71 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_voicing_vo |
72 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_note_priority_np |
73 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_portamento_po |
74 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_legato_mode_lg |
75 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_pitch_bend_range_br |
76 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_vibrato_range_vr |
77 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_vibrato_speed_vs |
78 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_transpose_tt |
79 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_fine_tuning_tf |
80 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_tuning_root_tr |
81 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_tuning_system_ts |
82 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_trigger_duration_t |
83 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_velocity_scale_t |
84 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_trigger_shape_t |
85 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_aux_cv_out_cv_3 |
86 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_oscillator_shape_os |
87 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_arp_seq_clock_division_c |
88 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_arp_seq_gate_length_g |
89 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_arp_range_ar_rg |
90 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_arp_direction_ad |
91 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_arp_pattern_ap_rp |
92 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_euclidean_length_e |
93 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_euclidean_fill_ef |
94 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_3/part_3_euclidean_rotate_er |
95 | 0–127 | continuous | RC channel: Part 3 | |
/yarns/rc_channel_part_4/part_4_midi_channel_ch |
100 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_lower_note_n |
101 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_upper_note_n |
102 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_midi_out_mode |
103 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_voicing_vo |
104 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_note_priority_np |
105 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_portamento_po |
106 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_legato_mode_lg |
107 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_pitch_bend_range_br |
108 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_vibrato_range_vr |
109 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_vibrato_speed_vs |
110 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_transpose_tt |
111 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_fine_tuning_tf |
112 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_tuning_root_tr |
113 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_tuning_system_ts |
114 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_trigger_duration_t |
115 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_velocity_scale_t |
116 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_trigger_shape_t |
117 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_aux_cv_out_cv_3 |
118 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_oscillator_shape_os |
119 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_arp_seq_clock_division_c |
120 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_arp_seq_gate_length_g |
121 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_arp_range_ar_rg |
122 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_arp_direction_ad |
123 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_arp_pattern_ap_rp |
124 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_euclidean_length_e |
125 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_euclidean_fill_ef |
126 | 0–127 | continuous | RC channel: Part 4 | |
/yarns/rc_channel_part_4/part_4_euclidean_rotate_er |
127 | 0–127 | continuous | RC channel: Part 4 |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /yarns/note/on <note> <velocity>, /yarns/cc/<number> <value>, /yarns/pitchbend <0-16383>, /yarns/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.