RefaceCPLiveControl

RefaceCPLiveControl is an Ableton Live Control Surface script for the Yamaha Reface CP keyboard.

Installation

1. Manually create a folder called Remote Scripts within your User Library if it does not already exist. The default User Library locations are:

   • Windows: \Users\[username]\Documents\Ableton\User Library
   • Mac: Macintosh HD/Users/[username]/Music/Ableton/User Library

2. Place the remote script folder called RefaceCP (the folder you found this README.md in) into the Remote Scripts from previous step.

You can also do this automatically with the make install command after setting the correct Live installation path in the Makefile.

Controls

Wave type knob:

Changes the MIDI transmit channel from 1 (Rdl type) to 6 (CP type). MIDI tracks with an input routing from the reface CP source and the selected MIDI channel are automatically selected and armed. This is useful to quickly change and play instruments from tracks on specific MIDI channels.

This also provides a lot more of flexibility to the custom MIDI mappings since each control can be mapped to any Live parameter across all 6 MIDI channels, effectively bringing up to 48 knobs, 18 toggles and 510 note keys for MIDI mapping in a Live Set.

Note: When mapping a control or key from the Reface using the custom user mapping Live overrides any special behaviour added by the script but in this case its functionality can still be reached by changing to any of the remaining unmapped MIDI channels for that control. Just prevent MIDI mapping the type knob so the channel can be changed.

Tremolo/Wah switch:

• Off: When the switch is in the middle position (off), the 8 right-most knobs follow and control the selected device.

• Tremolo On: When the switch is enabled, the 8 right-most knobs are locked to control a specific device.

• Wah On: Enables the track mode. This allows changing the selected track's volume, panning, sends A and B as well as the Mute, Solo and Arm buttons. In this mode the Drive knob is connected to the currently selected parameter in Live which can be very handy for quick automations.

Constraints

Sadly, the Reface CP does not send any MIDI CC for the Volume and Octave faders. It's also a pity that the Type knob is not an endless encoder. This limits the possibilities of what could be achieved when used as a controller but I hope this still brings a new dimension to your great Reface CP.

Links

This is a collection of resources that I found useful while researching on this project. I'm collecting them here both as a documentation source and acknowledgement.

• LOM - The Live Object Model: Official Live Object Model Documentation
• Live API version 11.0.0: Unofficial Live API documentation generated by the "API_MakeDoc" MIDI Remote Script. https://structure-void.com
• AbletonLive12_MIDIRemoteScripts: Unofficial repository for Ableton Live 12.0.1 MIDI Remote Scripts Python Sources by Julien Bayle / Structure Void
• _Framework: An Introduction to the Ableton Framework Classes by Hanz Petrov
• Ableton Script Documentation: Technical Documentation of the Ableton Live Remote Script for the Electra One (Jaap-Henk Hoepman)