What is the goal of these tutorials

Welcome to Control Surface Studio’s Step by Step tutorials. The goal of this tutorial is to take you from script building beginner, through to building your very own custom Script for your own MIDI Controller, simply and without writing a line of code.

No longer relying on the functionality provided by the Controller's Manufacturer or the limitations of Ableton Live’s own MIDI Mapping Mode. You will be able to build dynamic Scripts tailored to your own specific needs!.

Before going through this tutorial, you should have already installed Control Surface Studio on your Computer and logged in.

If you have not yet done this, please read through our Getting Started section.

The Control Surface Studio Application

Configuring your Settings Correctly

After logging in, the first thing you’ll want to do is ensure that your settings are all correct.

In the header, next to the Settings Icon you will see a red dot. The red dot tells you that your Settings are not configured correctly. Click the Icon to open the Settings menu.

the settings icon with red dot

In the settings Menu you will see a red box containing Alert messages.

the settings icon with red dot

The first thing is to set the correct location of the Ableton Live Application on your Computer. Click on the browse button next to ‘Ableton Live Location’. In the File Browser which opens, find and select the .exe (Windows) or .app (Mac) file for Ableton Live on your computer.

Selecting the Ableton Live Application

Once you have set it, the ‘MIDI Remote Script Folder Location’ will automatically update with the correct location of Live’s MIDI Remote Folder, and the Alert message ‘Ableton Live Location not set’ will disappear. Next click on the Menu next to ‘Live Version’, if you set your Live location correctly, then this should display all versions of Live you have available. Select the Version you are currently using. (make sure to update this when you change to a new version in future). After setting the 'Ableton Live Location', the App will automatically look for all Live versions in the following folder: Windows: C:\\UserName\\john\\AppData\\Roaming\\Ableton\\ Mac: /Users/UserName/Library/Preferences/Ableton/ If you do still do not see 'Live Version options appear, please check if this is where the Live version folders are stored on your computer. If you have your AppData folder set to a custom location then you will need to set the location of this manually in the settings.json file. See this Form post for further details:

live version menu

After setting your ‘Live Version’, ‘Log.txt location’ will automatically update with the path to the log.txt file for that version of live. It’s important that this is correct as the ‘Error Log’ Menu uses it to output Errors in any of your Scripts. If the path is wrong, you also have the option to manually set it using the Browse button.

live location browse button

If all red Alert Messages have now disappeared then you’re ready to move on.