Optibrium Community


CDD Vault Access from StarDrop

May 16, 2022

CDD Vault Access from StarDrop

May 16, 2022

This script provides the ability to connect directly to CDD Vault, run saved searches against projects of your choice and return the results directly into StarDrop.

Take a look at this short movie to see how it works…

The installer file and instructions for how to install and use the script are provided in the following pages…


This script is for StarDrop 7.3 for either Windows® or Mac®. To find out which version you have installed, start StarDrop and select the Help->About menu


We have recently updated StarDrop’s scripting to make it easier for everyone to download and install scripts without needing administrator privileges. If you are already using custom scripts that you downloaded and installed while using a previous version of StarDrop, then you will need to download these again (they have all been updated) and follow the installation instructions. If you are using any in-house scripts to access internal systems or databases, or are uncertain about what to do, then please contact [email protected] for assistance.

To install this script on Windows:

  • Ensure that you have saved your work and close StarDrop
  • Download the file StarDrop Script – CDD Vault.exe
  • When the download is complete, double-click the file to run it and follow the instructions (we recommend that you accept the default options provided)
  • Start StarDrop

To install this script on macOS or Windows:

  • Ensure that you have saved your work and close StarDrop
  • Download the file StarDrop Script – CDD Vault.zip
  • In your user area, navigate to the StarDrop Python folder (on Windows this is in C:\Users\username\AppData\Roaming\StarDrop\py3, on macOS this is in ~/StarDrop/py3)
  • Extract the contents of StarDrop Script – CDD Vault.zip into this folder overwriting any existing files
  • You should now see a folder called CDD Vault and a folder called Utils
  • Start StarDrop

For StarDrop 7.2 or earlier please use the following files:
On Windows – Download the file StarDrop Script – CDD Vault_py2.exe
On macOS or Windows – Download the file StarDrop Script – CDD Vault_py2.zip

To use this script…

…click on the Custom Scripts->CDD Vault menu and choose Retrieve Data. This will prompt you to enter a CDD key. To generate a key which will authenticate you each time you use this script (and which will be remembered after you have used it the first time), log in to CDD Vault, go to Settings and choose the API keys menu on the left. Here you will see an option to Add an API key (assuming that you do not have one already) which you can give a name. Once created it will be displayed as a long character string which you can copy and paste into the script dialogue. This will then be saved so that you do not need to enter it each time.

You will be prompted to select a search function. If you wish to retrieve response curve data with your search choose either the Download with response curve urls or Download with response curve plots options. If not, select Download data only. Note, if your saved search doesn’t include the ‘Molecule-Batch ID’ keyword you must select Download data only.

If you have access to more than one vault, then you will be shown a list of those available from which to choose. Once you have chosen a vault (or if you only have access to one vault), you can then choose one of your saved searches which will be run. If you have more than one project in your vault then you can choose which of these against which to run the search (you can select more than one project here if you wish). Finally, if you chose either of the response curve options, you will be prompted to select which protocol(s) to access. The search will then be run and the results returned into StarDrop.