CDP Interface Tool Installation Guide (for Renoise)

CDP is Composer’s Desktop Project, a sound design tool with tons of different programs for manipulating and processing sounds. A while ago, developers have generously decided to make it free and soon after, Afta8 and Djeorek on Renoise forums made a great tool for using it inside Renoise. (Thanks again guys!) I have done many tutorials covering it, but not one for setting it up – until now! (This is for Windows & Mac, see this post on Renoise blog for Linux.)

So let’s get down to it. I’ll try to keep this simple & concise.

WINDOWS:

  1. The very first step is going to CDP site http://www.unstablesound.net/cdp.html and downloading CDP package. Then install the package you downloaded into a folder convenient for you, probably something simple like “C:\cdpr7”.
  2. A crucial second step is setting up the environment variable. To do this on Windows you need to go to “Control Panel – System – Advanced System Settings – Environment Variables” and set “CDP_SOUND_EXT” it to “wav”. As shown here.
  3. Now download & install CDP Interface tool for Renoise: http://www.renoise.com/tools/cdp-interface
  4. Finally, time to run the tool for the first time to complete the installation. To do this, fire up Renoise, load up an audio sample and make sure it’s selected, then run the tool. When running for the first time it will ask for the _cdprogs directory. Select it by browsing to the cpdr7 location you’ve previously set up. For example it’s “C:\cdpr7\_cdp\_cdprogs” for me, as shown here.

OSX:

  1. The very first step is going to CDP site http://www.unstablesound.net/cdp.html and downloading CDP package. Then install the package you downloaded into your home directory which is the one with your username. If you have previously set it up to somewhere else, just move the folder over there.
  2. Now open a Terminal session (Applications->Utilities) and type env. Your cdp directory (yourusername/cdpr7/_cdp/_cdprogs) should be set correctly, something like this. If it is, skip to step 4.
    IMPORTANT: We now need to create a few files in TextEdit with weird extensions like .conf, .plist etc. To get these to work correctly, you need to make sure it’s a plain text file by checking “Format-> Make Plain Text”. If you are editing a Rich Text File instead, you won’t be able to save the file with a different extension, and it won’t work. Also uncheck the option to “add a .txt extension if none is provided” before saving.
  3. Create a plain text file as described above. Now copy the lines:
    PATH=$HOME/cdpr7/_cdp/_cdprogs:$PATH
    export PATH
    

    Then save this file as .bash_profile in your home directory. Now close Terminal and reopen. When you type “env”, it should be correct this time.

  4. Create a plain text file as described above. Now copy the lines:
    setenv  CDP_SOUND_EXT wav
    

    Then save this file as launchd.conf in your home directory. After that copy it into “etc” folder by executing sudo cp launchd.conf /etc command in Terminal which will ask for your password.

  5. Create another plain text file as described above. Copy this code:
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
      <key>Label</key>
      <string>my.startup</string>
      <key>ProgramArguments</key>
      <array>
        <string>sh</string>
        <string>-c</string>
        <string>launchctl setenv CDP_SOUND_EXT wav</string>
      </array>
      <key>RunAtLoad</key>
      <true/>
    </dict>
    </plist>

    Then save it somewhere (desktop, home w/e) as environment.plist file. After that copy this file to your Library/LaunchAgents (Finder->Go->”/Library/LaunchAgents”) folder and reboot.

  6. Now download & install CDP Interface tool for Renoise: http://www.renoise.com/tools/cdp-interface
  7. Finally, time to run the tool for the first time to complete the installation. To do this, fire up Renoise, load up an audio sample and make sure it’s selected, then run the tool. When running for the first time it will ask for the _cdprogs directory. Select it by browsing to the _cdprogs location in your home directory (~/cdpr7/_cdp/_cdprogs), as shown here.

And quite simply (for Windows at least), that’s it. Numerous things can go wrong though, most frequent being environment variable. If you haven’t set it up correctly, the tool will let you know and you should refer to the steps above to make sure you haven’t missed anything. If it’s still not working somehow, try steps below for troubleshooting (in no specific order):

  • Restarting Renoise and/or your computer. Simple but it worked for me on one occasion.
  • Reinstall the tool. This can help if you’ve messed up the “_cdprogs” directory somehow. If it still doesn’t work, try deleting the preferences.xml found in “User/Library/Preferences/Renoise/v3.x.x/Scripts/Tools/” and re-running the tool.
  • For OSX, manualconfig.pdf file found in cdpr7/doc directory describes the installation process in steps 2-5 in more detail. It’s a bit confusing for me (just like every CDP document ever!), so I decided to try to explain it in simpler terms above, but if it fails, take a look at this document.
  • If it’s still not working, best ask about it on Renoise forum, or CDP forum. You can also simply leave a comment below and I’ll try to help!

That’s all. I’d love to hear if it’s been helpful to you – or not, so that I can improve this post to be as useful and understandable as it could be. So yeah, let me know!

-Emre.

Update June 2016: I’ve split the guide for Win & Mac. Overhauled the Mac section. Was able to set up a fresh install on Yosemite by following these steps, so it should be working correctly.