Manually Installing Max for Live Liquid Rhythm Patch

Installing Max for Live Liquid Rhythm

As we work to improve our installers, there is always a chance it makes a mistake, and doesn’t recognize your installed Ableton Live 9 environment.   However, you still want to use Liquid Rhythm through our Max For Live clip integration (why wouldn’t you, its awesome!  – I might be biased though).   Here are the steps that can be manually used for installing Max For Live Liquid Rhythm patch.  Thus it will allow LiquidRhythm.amxd to be installed properly into your system.  If you have any questions or concerns, please don’t hesitate to contact support@wavedna.com or browse through our forums.

In a Nutshell…

Liquid Rhythm is written in Java which means we need to give instructions to Max For Live to discover where the WaveDNA Java libraries are located.  There are two parts required to do this, one is a javascript file, liquidclipsinstaller.js,  that will setup all the path every time you launch Liquid Rhythm through Max For Live.  Second there is an update to the Max 6.1′s max.java.config.txt, which is a configuration file, that is used to setup the Java environment for Max For Live.  Once both of these these two important files are ready, then our LiquidRhythm.amxd will run properly.

Steps for Mac

Please goto to this page for instructions for Mac OSX

Steps for Windows for Liquid Rhythm Version 1.3.2 and higher

  1. We need to edit ‘max.java.config.txt‘ file to contain the special instructions required by Liquid Rhythm to startup correctly.   It is possible the installer has already made an entry, in which case we are just verifying the correct information is it it.Use a text editor (like wordpad) to open the following file.  It is instructions for Max For Live that need to be copied carefully.:
    C:\Program Files (x86)\WaveDNA\Liquid Rhythm\plugins\com.wavedna.liquidclips\source\LiquidClipsMaxBlock_WIN.txt

    It should look like the following:

    Block of configuration for Liquid Rhythm to be edited and inserted into Max.java.config.txt
    Block of configuration for Liquid Rhythm to be edited and inserted into Max.java.config.txt

    You need to change two places in this text, and its not hard.

    1. We need to give the path to .jar (which are Java libraries) that contain the code needed for Liquid Rhythm.  We need to replace @_clips_system_jar_path_@ with this path.  Its important to keep the quote “, to use the capital letter for the drive (ie C) and have forward slashes ‘/’ , not the usual backslash used by windows.  Here is the path you would want to insert (please verify its correct for your system based on where you installed Liquid Rhythm).  Also very important, that the _1.2.3 will change with the version you have installed, so please verify you have the correct path.
      C:\Program Files (x86)\WaveDNA\Liquid Rhythm\plugins\com.wavedna.audiolauncher.win32_1.2.3\MaxFramework\LiquidLoops.app\support\java\lib

      Thus you would insert the following that the place of a) as one line.

      max.system.jar.dir "C:/Program Files (x86)/WaveDNA/Liquid Rhythm/plugins/com.wavedna.audiolauncher.win32_1.2.3/MaxFramework/LiquidLoops.app/support/java/lib"

      Notice the surrounding quotes, the forward slashes and that the drive letter is capitalized.

    2. Next we need the path to the installed Liquid Rhythm.  We need to replace @_clips_lr_appbase_@  with your install path for Liquid Rhythm.  So the new line would become in my case:
      ;com.wavedna.liquidclips.appbase=C:/Program Files (x86)/WaveDNA/Liquid Rhythm

      Again please notice that the usual Microsoft Windows backslash ‘\’ is converted to a forward slash ‘/’.  Notice the drive letter is capitalized.  This line doesn’t need the quotes.

  2. Next we need to edit the ‘max.java.config.txt‘ files.  You will find them in the following locations.  If you have 32-bit Max 6.1 installed, you will find it the ‘max.java.config.txt‘ here:
    C:\Program Files (x86)\Cycling '74\Max 6.1\Cycling '74\java

    If you have 64-bit Max 6.1 installed, you will likely find it in this folder:

    C:\Program Files\Cycling '74\Max 6.1\Cycling '74\java

    To edit this file you need stronger permission.  You need to open a ‘notepad’ with Administrator permission.  You do this by typing ‘notepad’ in the Windows Start search bar, and when the notepad icon appears, you right-click and choose run as administrator.  Here is an example on Window 7

    Running Notepad as Administrator Example on Windows 7
    Running Notepad as Administrator Example on Windows 7

    Then you need to open the ‘max.java.config.txt‘ in the appropriate folder (or both if you have them installed).  Search to the bottom of the file, and then add the text previously edited, and save the file.  Please verify the notes as suggested above.  Also, please check to see if this block already exists, and replace it with your content if different.

  3. Finally we need to copy the ‘LiquidRhythm.amxd’ into the proper Ableton folder which contain all of the other Max for Live MIDI Effects.  On Windows 7, this is installed into the ‘Documents’ folder under your username:
    C:\Users\<username>\Documents\Ableton\User Library\Presets\MIDI Effects\Max MIDI Effect

    ‘LiquidRhythm.amxd’ actually exists in the Liquid Rhythm install directory under a different name.  It is called ‘LiquidClipsInstaller.amxd‘ and as part of the installation process, it will get copied into the directory mentioned above, and renamed into ‘LiquidRhythm.amxd‘.   You will find it in the following directory:

    C:\Program Files (x86)\WaveDNA\Liquid Rhythm\plugins\com.wavedna.liquidclips\source

Steps for Windows for Liquid Rhythm Version 1.3.1 and Older

  1. We need to copy ‘liquidclipsinstaller.js‘ into Max 6.1 ‘patches‘ folder. You can find ‘liquidclipsinstaller.js‘ in Liquid Rhythm install directory, under the Liquidclips plugin folder. For example this folder would contain ‘liquidclipsinstaller.js‘:
    C:\Program Files (x86)\WaveDNA\Liquid Rhythm\plugins\com.wavedna.liquidclips\source

    This needs to be copied into Max 6.1 patches folder.  Its important to note that you can Max 6.1 installed in different places by default, and its based by the bit architecture for Max 6.1.   If you have both 32-bit and 64-bit Ableton Live 9 installed, and would like to run Liquid Rhythm with both Abletons, you will need to follow the instruction for both folders.For the 32-bit Max 6.1, its default path is:

    C:\Program Files (x86)\Cycling '74\Max 6.1\patches\

    For the 64-bit Max 6.1, its default path is:

    C:\Program Files\Cycling '74\Max 6.1\patches\

    You need to create a sub-folder for ‘com.wavedna.liquidclips.installer‘ and a sub-folder within that called ‘javascript‘. Thus you would be copying the ’liquidclipsinstaller.js’ into the following path in the 32-bit case:

    C:\Program Files (x86)\Cycling '74\Max 6.1\patches\com.wavedna.liquidclips.installer\javascript

    In the end, your folder should look something like this:

    Javascript path installer for Liquid Rhythm in Max For Live

    Javascript path installer for Liquid Rhythm in Max For Live

  2. We need to edit ‘max.java.config.txt‘ file to contain the special instructions required by Liquid Rhythm to startup correctly.   It is possible the installer has already made an entry, in which case we are just verifying the correct information is it it.Use a text editor (like wordpad) to open the following file.  It is instructions for Max For Live that need to be copied carefully.:
    C:\Program Files (x86)\WaveDNA\Liquid Rhythm\plugins\com.wavedna.liquidclips\source\LiquidClipsMaxBlock_WIN.txt

    It should look like the following:

    Block of configuration for Liquid Rhythm to be edited and inserted into Max.java.config.txt

    Block of configuration for Liquid Rhythm to be edited and inserted into Max.java.config.txt

    You need to change two places in this text, and its not hard.

    1. We need to give the path to .jar (which are Java libraries) that contain the code needed for Liquid Rhythm.  We need to replace @_clips_system_jar_path_@ with this path.  Its important to keep the quote “, to use the capital letter for the drive (ie C) and have forward slashes ‘/’ , not the usual backslash used by windows.  Here is the path you would want to insert (please verify its correct for your system based on where you installed Liquid Rhythm).  Also very important, that the _1.2.3 will change with the version you have installed, so please verify you have the correct path.
      C:\Program Files (x86)\WaveDNA\Liquid Rhythm\plugins\com.wavedna.audiolauncher.win32_1.2.3\MaxFramework\LiquidLoops.app\support\java\lib

      Thus you would insert the following that the place of a) as one line.

      max.system.jar.dir "C:/Program Files (x86)/WaveDNA/Liquid Rhythm/plugins/com.wavedna.audiolauncher.win32_1.2.3/MaxFramework/LiquidLoops.app/support/java/lib"

      Notice the surrounding quotes, the forward slashes and that the drive letter is capitalized.

    2. Next we need the path to the installed Liquid Rhythm.  We need to replace @_clips_lr_appbase_@  with your install path for Liquid Rhythm.  So the new line would become in my case:
      ;com.wavedna.liquidclips.appbase=C:/Program Files (x86)/WaveDNA/Liquid Rhythm

      Again please notice that the usual Microsoft Windows backslash ‘\’ is converted to a forward slash ‘/’.  Notice the drive letter is capitalized.  This line doesn’t need the quotes.

  3. Next we need to edit the ‘max.java.config.txt‘ files.  You will find them in the following locations.  If you have 32-bit Max 6.1 installed, you will find it the ‘max.java.config.txt‘ here:
    C:\Program Files (x86)\Cycling '74\Max 6.1\Cycling '74\java

    If you have 64-bit Max 6.1 installed, you will likely find it in this folder:

    C:\Program Files\Cycling '74\Max 6.1\Cycling '74\java

    To edit this file you need stronger permission.  You need to open a ‘notepad’ with Administrator permission.  You do this by typing ‘notepad’ in the Windows Start search bar, and when the notepad icon appears, you right-click and choose run as administrator.  Here is an example on Window 7

    Running Notepad as Administrator Example on Windows 7

    Running Notepad as Administrator Example on Windows 7

    Then you need to open the ‘max.java.config.txt‘ in the appropriate folder (or both if you have them installed).  Search to the bottom of the file, and then add the text previously edited, and save the file.  Please verify the notes as suggested above.  Also, please check to see if this block already exists, and replace it with your content if different.

  4. Finally we need to copy the ‘LiquidRhythm.amxd’ into the proper Ableton folder which contain all of the other Max for Live MIDI Effects.  On Windows 7, this is installed into the ‘Documents’ folder under your username:
    C:\Users\<username>\Documents\Ableton\User Library\Presets\MIDI Effects\Max MIDI Effect

    ‘LiquidRhythm.amxd’ actually exists in the Liquid Rhythm install directory under a different name.  It is called ‘LiquidClipsInstaller.amxd‘ and as part of the installation process, it will get copied into the directory mentioned above, and renamed into ‘LiquidRhythm.amxd‘.   You will find it in the following directory:

    C:\Program Files (x86)\WaveDNA\Liquid Rhythm\plugins\com.wavedna.liquidclips\source