Skip to content

Mutable Instruments Yarns Loom: MIDI CC, NRPN and OSC map

The Mutable Instruments Yarns Loom as named OSC addresses — 181 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.

Device Mutable Instruments Yarns Loom
Vendor Mutable Instruments
OSC prefix /yarns_loom
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_loom.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_loom.json --out-port <N> --in-port <M>

Then send OSC to 127.0.0.1:7777, for example:

osc-bridge osc-send /yarns_loom/part_channel/vibrato_depth 63

From Claude or any MCP client, the osc-bridge mcp server exposes this driver as yarns_loom: ask “what can the Mutable Instruments Yarns Loom do?” and it reads this map with list_routes. See the MCP guide.

MIDI CC and NRPN parameters (181)

OSC address CC NRPN (MSB/LSB) Range Nature Section
/yarns_loom/part_channel/vibrato_depth 1 0–127 continuous Part channel
/yarns_loom/part_channel/aux_cv_1 2 0–127 continuous Part channel
/yarns_loom/part_channel/aux_cv_2 4 0–127 continuous Part channel
/yarns_loom/part_channel/glide_time 5 0–127 continuous Part channel
/yarns_loom/part_channel/lower_note 16 0–127 continuous Part channel
/yarns_loom/part_channel/upper_note 17 0–127 continuous Part channel
/yarns_loom/part_channel/voicing 18 0–127 continuous Part channel
/yarns_loom/part_channel/note_priority 19 0–127 continuous Part channel
/yarns_loom/part_channel/legato_retrigger_off_on 20 0–127 continuous Part channel
/yarns_loom/part_channel/pitch_bend_range 21 0–127 continuous Part channel
/yarns_loom/part_channel/vibrato_range 22 0–127 continuous Part channel
/yarns_loom/part_channel/lfo_rate_for_vibrato_tremolo_timbre_lfo 23 0–127 continuous Part channel
/yarns_loom/part_channel/transpose_semitones 24 0–127 continuous Part channel
/yarns_loom/part_channel/fine_tuning 25 0–127 continuous Part channel
/yarns_loom/part_channel/tuning_root 26 0–127 continuous Part channel
/yarns_loom/part_channel/tuning_system 27 0–127 continuous Part channel
/yarns_loom/part_channel/trigger_duration 28 0–127 continuous Part channel
/yarns_loom/part_channel/trigger_velocity_scale 29 0–127 continuous Part channel
/yarns_loom/part_channel/trigger_shape 30 0–127 continuous Part channel
/yarns_loom/part_channel/aux_cv_out 31 0–127 continuous Part channel
/yarns_loom/part_channel/portamento_legato_only_off_on 32 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_mode_off_drone_enveloped 70 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_waveform 71 0–127 continuous Part channel
/yarns_loom/part_channel/aux_cv_out_2 72 0–127 continuous Part channel
/yarns_loom/part_channel/input_transposes_octaves 73 0–127 continuous Part channel
/yarns_loom/part_channel/hold_pedal_mode 74 0–127 continuous Part channel
/yarns_loom/part_channel/sequencer_mode_loop_step 75 0–127 continuous Part channel
/yarns_loom/part_channel/sequencer_input_response 76 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_attack_time_initial 77 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_decay_time_initial 78 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_sustain_level_initial 79 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_release_time_initial 80 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_timbre_lfo_shape 81 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_timbre_initial 82 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_timbre_unipolar_modulation_by_bipolar_lfo 83 0–127 continuous Part channel
/yarns_loom/part_channel/loop_length_in_quarter_notes 84 0–127 continuous Part channel
/yarns_loom/part_channel/hold_pedal_polarity_positive_negative 85 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_attack_time_bipolar_modulation_by_velocity 86 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_decay_time_bipolar_modulation_by_velocity 87 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_sustain_level_bipolar_modulation_by_velocity 88 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_release_time_bipolar_modulation_by_velocity 89 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_timbre_bipolar_modulation_by_envelope_initial 90 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_timbre_bipolar_modulation_by_envelope_bipolar_modulation_depth_by_velocity 91 0–127 continuous Part channel
/yarns_loom/part_channel/envelope_peak_bipolar_scaling_by_velocity 92 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_envelope_tremolo_depth 93 0–127 continuous Part channel
/yarns_loom/part_channel/oscillator_envelope_tremolo_shape 94 0–127 continuous Part channel
/yarns_loom/part_channel/vibrato_shape 95 0–127 continuous Part channel
/yarns_loom/part_channel/arp_seq_clock_ratio 102 0–127 continuous Part channel
/yarns_loom/part_channel/arp_seq_gate_length 103 0–127 continuous Part channel
/yarns_loom/part_channel/arp_range 104 0–127 continuous Part channel
/yarns_loom/part_channel/arp_direction 105 0–127 continuous Part channel
/yarns_loom/part_channel/arp_pattern 106 0–127 continuous Part channel
/yarns_loom/part_channel/euclidean_length 107 0–127 continuous Part channel
/yarns_loom/part_channel/euclidean_fill 108 0–127 continuous Part channel
/yarns_loom/part_channel/step_offset_euclidean_rotate 109 0–127 continuous Part channel
/yarns_loom/part_channel/sequencer_recording_off_on 110 0–127 continuous Part channel
/yarns_loom/part_channel/delete_sequencer_recording 111 0–127 continuous Part channel
/yarns_loom/part_channel/record_tie_step_remove_oldest_note_loop 112 0–127 continuous Part channel
/yarns_loom/part_channel/record_rest_step_remove_newest_note_loop 113 0–127 continuous Part channel
/yarns_loom/part_channel/play_mode_manual_arpeggiator_sequencer 114 0–127 continuous Part channel
/yarns_loom/part_channel/loop_sequencer_phase_offset 115 0–127 continuous Part channel
/yarns_loom/part_channel/macro_recording_mode 116 0–127 continuous Part channel
/yarns_loom/part_channel/macro_play_sequencer_mode 117 0–127 continuous Part channel
/yarns_loom/part_channel/lfo_spread_types 118 0–127 continuous Part channel
/yarns_loom/part_channel/lfo_spread_voices 119 0–127 continuous Part channel
/yarns_loom/rc_channel_global/output_clock_ratio 0 0–127 continuous RC channel: Global
/yarns_loom/rc_channel_global/layout 1 0–127 continuous RC channel: Global
/yarns_loom/rc_channel_global/tempo 2 0–127 continuous RC channel: Global
/yarns_loom/rc_channel_global/swing 3 0–127 continuous RC channel: Global
/yarns_loom/rc_channel_part_1/part_1_midi_channel_ch 4 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_lower_note_n 5 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_upper_note_n 6 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_midi_out_mode 7 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_voicing_vo 8 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_note_priority_np 9 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_portamento_po 10 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_legato_mode_lg 11 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_pitch_bend_range_br 12 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_vibrato_range_vr 13 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_vibrato_speed_vs 14 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_transpose_tt 15 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_fine_tuning_tf 16 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_tuning_root_tr 17 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_tuning_system_ts 18 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_trigger_duration_t 19 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_velocity_scale_t 20 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_trigger_shape_t 21 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_aux_cv_out_cv_3 22 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_oscillator_shape_os 23 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_arp_seq_clock_division_c 24 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_arp_seq_gate_length_g 25 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_arp_range_ar_rg 26 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_arp_direction_ad 27 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_arp_pattern_ap_rp 28 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_euclidean_length_e 29 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_euclidean_fill_ef 30 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_1/part_1_euclidean_rotate_er 31 0–127 continuous RC channel: Part 1
/yarns_loom/rc_channel_part_2/part_2_midi_channel_ch 36 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_lower_note_n 37 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_upper_note_n 38 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_midi_out_mode 39 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_voicing_vo 40 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_note_priority_np 41 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_portamento_po 42 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_legato_mode_lg 43 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_pitch_bend_range_br 44 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_vibrato_range_vr 45 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_vibrato_speed_vs 46 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_transpose_tt 47 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_fine_tuning_tf 48 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_tuning_root_tr 49 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_tuning_system_ts 50 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_trigger_duration_t 51 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_velocity_scale_t 52 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_trigger_shape_t 53 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_aux_cv_out_cv_3 54 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_oscillator_shape_os 55 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_arp_seq_clock_division_c 56 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_arp_seq_gate_length_g 57 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_arp_range_ar_rg 58 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_arp_direction_ad 59 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_arp_pattern_ap_rp 60 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_euclidean_length_e 61 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_euclidean_fill_ef 62 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_2/part_2_euclidean_rotate_er 63 0–127 continuous RC channel: Part 2
/yarns_loom/rc_channel_part_3/part_3_midi_channel_ch 68 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_lower_note_n 69 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_upper_note_n 70 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_midi_out_mode 71 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_voicing_vo 72 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_note_priority_np 73 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_portamento_po 74 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_legato_mode_lg 75 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_pitch_bend_range_br 76 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_vibrato_range_vr 77 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_vibrato_speed_vs 78 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_transpose_tt 79 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_fine_tuning_tf 80 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_tuning_root_tr 81 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_tuning_system_ts 82 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_trigger_duration_t 83 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_velocity_scale_t 84 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_trigger_shape_t 85 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_aux_cv_out_cv_3 86 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_oscillator_shape_os 87 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_arp_seq_clock_division_c 88 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_arp_seq_gate_length_g 89 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_arp_range_ar_rg 90 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_arp_direction_ad 91 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_arp_pattern_ap_rp 92 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_euclidean_length_e 93 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_euclidean_fill_ef 94 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_3/part_3_euclidean_rotate_er 95 0–127 continuous RC channel: Part 3
/yarns_loom/rc_channel_part_4/part_4_midi_channel_ch 100 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_lower_note_n 101 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_upper_note_n 102 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_midi_out_mode 103 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_voicing_vo 104 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_note_priority_np 105 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_portamento_po 106 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_legato_mode_lg 107 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_pitch_bend_range_br 108 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_vibrato_range_vr 109 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_vibrato_speed_vs 110 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_transpose_tt 111 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_fine_tuning_tf 112 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_tuning_root_tr 113 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_tuning_system_ts 114 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_trigger_duration_t 115 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_velocity_scale_t 116 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_trigger_shape_t 117 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_aux_cv_out_cv_3 118 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_oscillator_shape_os 119 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_arp_seq_clock_division_c 120 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_arp_seq_gate_length_g 121 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_arp_range_ar_rg 122 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_arp_direction_ad 123 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_arp_pattern_ap_rp 124 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_euclidean_length_e 125 0–127 continuous RC channel: Part 4
/yarns_loom/rc_channel_part_4/part_4_euclidean_fill_ef 126 0–127 continuous RC channel: Part 4
/yarns_loom/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_loom/note/on <note> <velocity>, /yarns_loom/cc/<number> <value>, /yarns_loom/pitchbend <0-16383>, /yarns_loom/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.