Installation:

LoopCode has two components that must both be installed: The program itself and the "Remote Script", which is a feature of Ableton Live and must be copied into it's directory.

Windows:

Unzip the download and double click LoopCode.exe to run

Unzip LoopCodeRemote.zip which should create a LoopCodeRemote folder.  Copy this folder to c:\ProgramData\Ableton\Live x.x\Resources\MIDI Remote Scripts\

Mac:

Open the disk image and drag LoopCode to your applications directory.  Double click to run.

Locate the Live application in Finder, right click on it and select "Show Package Content". Then navigate to: /Contents/App-Resources/MIDI Remote Scripts/ .  Copy the LoopCodeRemote folder to this directory.

Configuration:

In Ableton open Preferences and go to the MIDI tab. In a free Control Surface slot choose LoopCodeRemote.

It's not necessary for regular commands, but if you wish to be able to send and receive MIDI messages during your set you will need to install a MIDI loopback driver.  For Windows I recommend loopMIDI by Tobias Erichsen.  On Mac you can follow these instructions from Ableton.

Getting Started:

The first time you run LoopCode you will be prompted to create a set list file.  Choose or create a folder to hold the set file and any song files you create.

Scenes:

LoopCode works by sending scenes.  Each scene is a page of commands.  They can hold as many commands as you need for that moment.  They are sent as soon as the page loads unless the MUTE button is activated (except for the when LoopCode is first started).  This makes the NEXT button the most important one since it will take you through your song and set, sending each scene after you press it.  It is highly recommended to link a midi controller to this button, which listens on CC 99 Channel 16.  If you hit the NEXT button while on the last scene of a song it will load the first scene of the next song.

You might need a some commands to prepare your Ableton set before each song starts.  This is what the PRE-SONG CODE is for: to reset the stage if you need.  It can be entered on the right side after hitting the SETLIST button.

The Setlist:

A setlist is a simply a list of songs and any pre-song commands to be run.  The SETLIST button on the top right brings up the editor.  LOAD SONG is how you add existing song files to the set. REMOVE SONG takes a song out of the set but does not delete or change the song file. NEW SONG starts a new blank song file in the set directory.  Use the TITLE and FILE NAME fields below the setlist to give the new song its name.

Changes to a setlist or song will not take effect until the SAVE SET button is pressed.  You can have any number of setlist files which have different collections or orders of songs.  To keep your changes in a new set file use the SAVE SET AS button.  Use the LOAD SET button to switch between your various set files.  The most recently used set file will be loaded when LoopCode starts.