[
  {
    "path": ".gitignore",
    "content": "$RECYCLE.BIN\n.fseventsd\n.Trashes\n.DS_Store\n.vscode\n.vs\n*.ncb\n*.suo\n*.sdf\n*.opensdf\n*.pbxuser\n*.perspectivev3\n*.user\n*.xcworkspacedata\n*.VC.db*\n*.VC.opendb*\n*.ipch\nversion.properties\nxcuserdata\nARTIFACTS\nbuild\nout\n"
  },
  {
    "path": ".gitmodules",
    "content": "[submodule \"ARA_API\"]\n\tpath = ARA_API\n\turl = https://github.com/Celemony/ARA_API\n[submodule \"ARA_Library\"]\n\tpath = ARA_Library\n\turl = https://github.com/Celemony/ARA_Library\n[submodule \"ARA_Examples\"]\n\tpath = ARA_Examples\n\turl = https://github.com/Celemony/ARA_Examples\n"
  },
  {
    "path": "NOTICE.txt",
    "content": "ARA Audio Random Access SDK Installer\n\nThis module bundles the ARA API, ARA Library and ARA Examples\nby Celemony Software GmbH as ARA Audio Random Access SDK,\navailable under the Apache License 2.0.\nFor details, see ARA_API, ARA_Library and ARA_Examples.\n\n\nThis module bundles cpp-base64, developed by René Nyffenegger,\navailable under the \"zlib\" license.\nFor details, see ARA_Examples/3rdParty/cpp-base64.\n\nThis module bundles pugixml, developed by Arseny Kapoulkine,\navailable under the \"MIT\" license.\nFor details, see ARA_Examples/3rdParty/pugixml.\n\nThis module bundles the AudioFile component of the ICST DSP library,\nextended to read and write iXML data chunks, developed by the\nZurich University of the Arts, Beat Frei, and Celemony Software GmbH,\navailable under the \"2-clause BSD\" license.\nFor details, see ARA_Examples/3rdParty/ICST_AudioFile.\n\n\nThis module optionally installs a subset of the VST3 SDK,\ndeveloped by Steinberg Media Technologies GmbH,\navailable under the Propritary Steinberg VST3 License or\nalternatively under the General Public License (GPL) Version 3,\nsee LICENSE.txt included there.\n\nThis module optionally installs the CoreAudio Utility Classes,\ndeveloped by Apple Inc.,\navailable under a custom Apple sample code license contained in each\nsource file therein.\n\nThis module optionally installs the JUCE_ARA fork of the JUCE SDK,\ndeveloped by Raw Material Software Limited and Celemony Software GmbH,\navailable under a variety of licenses including the\nGeneral Public License (GPL) Version 3,\nsee LICENSE.md included there.\n\n\nTHIS SOFTWARE IS PROVIDED BY CELEMONY SOFTWARE GMBH AND CONTRIBUTORS \"AS IS\"\nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE DISCLAIMED.\nIN NO EVENT SHALL CELEMONY SOFTWARE GMBH AND/OR CONTRIBUTORS BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\nON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\nTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n"
  },
  {
    "path": "README.md",
    "content": "# ARA Audio Random Access: Software Development Kit Installer\n\n## About ARA and the ARA SDK\n\nARA Audio Random Access is an extension for established plug-in standard APIs such as\n[`VST3`](https://github.com/steinbergmedia/vst3sdk),\n[`Audio Units`](https://developer.apple.com/documentation/audiotoolbox),\n[`AAX`](https://developer.avid.com/aax/) or [`CLAP`](https://cleveraudio.org/) to allow for a\nmuch-improved DAW integration of plug-ins like Celemony's Melodyne which are conceptually\ncloser to a sample editor than to a conventional realtime audio processor.\nIt enables plug-ins to read audio samples from the DAW host at will, allowing them to implement more\nsophisticated processing algorithms not possible when being tied to individual realtime buffers.\nARA further defines bi-directional exchange of audio content information such as tempo, keys and scales\nbetween plug-in and host, upon which both host and plug-ins can build numerous advanced editing features.\n\nThis Software Development Kit allows digital audio workstation (DAW) plug-in and host developers to\nimplement and utilize ARA enabled plug-ins.\nIt is copyright (c) 2012-2026, [Celemony Software GmbH](https://www.celemony.com), and published under\nthe [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).\n\nAny public release of ARA-enabled software should be based on a tagged public release of the ARA API.\nIf temporarily using HEAD to study current work-in-progress, keep in mind that in order to achieve a\nconcise long-term change history, any changes since the last tagged release may eventually be rebased.\n\n\n## ARA SDK Submodules\n\nThe ARA SDK consists of three components which are distributed as individual Git submodules so that\ndependent projects can pick only those parts of the SDK that are needed in their context.\nAfter cloning this top level module, you need to fetch these submodules, e.g. by running:\n\n    git submodule update --init --recursive\n\n\n### ARA API\n\nThe `ARA_API` module contains the core headers that define the actual ARA C API.\n`ARAInterface.h` is the main header, accompanied by a set of auxiliary headers for integrating ARA with\neach of the supported companion APIs like `VST3` or `Audio Units`. Additionally, ARA Audio File Chunks\nare defined in `ARAAudioFileChunks.h`.\nIt includes extensive printer-friendly [documentation](ARA_API/ARA_API.pdf).\n\n### ARA Library\n\nThe `ARA_Library` module wraps the low-level ARA C API with extensive C++11 classes and provides\nadditional utility code that aides developers when implementing ARA-enabled products.\nIt includes extensive browser-friendly [documentation](ARA_Library/html_docs/index.html).\n\n### ARA Examples\n\nThe `ARA_Examples` module contains various sample code demonstrating how to both implement and host\nARA enabled plug-ins. For details on building and running the examples, see their accompanying\n[README](ARA_Examples/README.md).\nNote that some of the examples rely on external dependencies, see separate\n[3rd party README](ARA_Examples/3rdParty/README.md).\n\n\n## Companion APIs\n\nBuilding ARA-enabled products relies on using at least one of the various established plug-in standard\nAPIs as \"companion API\" to ARA. Note that each of the companion APIs comes with its own specific licensing\nconditions, as detailed in each SDK - some of these terms differ substantially from ARA's licensing conditions.\nThe companion APIs are therefore not installed automatically. However where applicable, optional install\nscripts for these SDKs are provided as convenience.\nPer default, these scripts will place the SDKs inside the ARA SDK folder, but this can be overridden\nby specifying alternate locations for each SDK, e.g. for VST3 by adding the argument:\n\n    -D ARA_VST3_SDK_DIR:PATH=\"your/path/to/vst3sdk\"\n\n\n### VST3 SDK\n\nYou can set the variable ARA_VST3_SDK_DIR to an already existing local copy of the Steinberg VST3 SDK\nwhen generating the ARA example projects.\nAlternatively, a subset of the [VST3 SDK](https://github.com/steinbergmedia/vst3sdk) sufficient for building\nthe ARA examples can be fetched from GitHub via:\n\n    cmake -P install_vst3sdk.cmake\n\n### Audio Unit SDK\n\nSimilar to VST3, you can set ARA_AUDIO_UNIT_SDK_DIR to use an existing local copy of Apple's\nAudio Unit SDK (former Core Audio Utility Classes).\nThey can also be downloaded directly from the [Apple github page](https://github.com/apple/AudioUnitSDK):\n\n    cmake -P install_AudioUnitSDK.cmake\n\n### CLAP SDK\n\nSimilar to VST3, you can set ARA_CLAP_SDK_DIR to use an existing local copy of the CLAP SDK, which\ncan be downloaded directly from the [CLAP github page](https://github.com/free-audio/clap):\n\n    cmake -P install_CLAP.cmake\n\n### AAX SDK\n\nThe ARA AAX integration is an optional part of the AAX SDK and not included here. The AAX SDK can be\ndownloaded from Avid after registering with them, see [Avid's developer site](https://developer.avid.com/aax/).\n\n\n## Optional JUCE ARA Example\n\nIn order to provide an example with extensive UI, Celemony has created an [experimental fork](https://github.com/Celemony/JUCE_ARA)\nof the [JUCE framework](https://juce.com) which contains an extended ARA demo plug-in that allows\nfor studying ARA GUI integration both for host and plug-in developers.\n\nNote that like some of the companion APIs, JUCE imposes very different licensing conditions than the\nARA SDK itself, see its included documentation.\n\nTo download this optional module run:\n\n    cmake -P install_JUCE_ARA.cmake\n\nNow build and launch the Projucer found in extras/Projucer/Builds,\nchoose Open Example > Plugins > ARAPluginDemo and export the project for your IDE of choice.\n"
  },
  {
    "path": "install_AudioUnitSDK.cmake",
    "content": "# CMake script to install the Apple Core Audio Utilities right next to the script,\n# or to a custom location provided via AUDIOUNIT_SDK_DIR.\n#\n# See README.md and NOTICE.txt for details.\n#\n# THIS SOFTWARE IS PROVIDED BY CELEMONY SOFTWARE GMBH AND CONTRIBUTORS \"AS IS\"\n# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n# IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n# PARTICULAR PURPOSE ARE DISCLAIMED.\n# IN NO EVENT SHALL CELEMONY SOFTWARE GMBH AND/OR CONTRIBUTORS BE LIABLE FOR\n# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\n# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\n# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\ncmake_minimum_required(VERSION 3.19 FATAL_ERROR)\n\nif(NOT APPLE)\n    message(FATAL_ERROR \"The Audio Unit SDK can only be used on Apple platforms.\")\nendif()\n\nif(NOT AUDIOUNIT_SDK_DIR)\n    set(AUDIOUNIT_SDK_DIR \"${CMAKE_CURRENT_LIST_DIR}/AudioUnitSDK\")\nendif()\n\nif(EXISTS \"${AUDIOUNIT_SDK_DIR}\")\n    if(EXISTS \"${AUDIOUNIT_SDK_DIR}/CoreAudio/AudioUnits/AUPublic\")\n        message(STATUS \"Core Audio Utility Classes seem to be already installed in '${AUDIOUNIT_SDK_DIR}'.\")\n    else()\n        message(FATAL_ERROR \"There already exists a file or folder named '${AUDIOUNIT_SDK_DIR}' but it does not seem to contain the Core Audio Utility Classes.\")\n    endif()\nelse()\n    message(STATUS \"Cloning AudioUnitSDK to '${AUDIOUNIT_SDK_DIR}'...\")\n    execute_process(COMMAND git clone --depth=1 --shallow-submodules --single-branch --no-tags --progress --branch AudioUnitSDK-1.0.0 https://github.com/apple/AudioUnitSDK \"${AUDIOUNIT_SDK_DIR}\" RESULT_VARIABLE result)\n    if(result)\n        message(FATAL_ERROR \"Cloning repository failed: ${result}\")\n    endif()\nendif()\n"
  },
  {
    "path": "install_CLAP.cmake",
    "content": "# CMake script to install a subset of the Steinberg VST3 SDK right next to the script,\n# or to a custom location provided by VST3_SDK_DIR.\n#\n# See README.md and NOTICE.txt for details.\n#\n# THIS SOFTWARE IS PROVIDED BY CELEMONY SOFTWARE GMBH AND CONTRIBUTORS \"AS IS\"\n# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n# IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n# PARTICULAR PURPOSE ARE DISCLAIMED.\n# IN NO EVENT SHALL CELEMONY SOFTWARE GMBH AND/OR CONTRIBUTORS BE LIABLE FOR\n# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\n# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\n# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\ncmake_minimum_required(VERSION 3.19 FATAL_ERROR)\n\nif(NOT CLAP_SDK_DIR)\n    set(CLAP_SDK_DIR \"${CMAKE_CURRENT_LIST_DIR}/CLAP\")\nendif()\n\nif(EXISTS \"${CLAP_SDK_DIR}\")\n    if(EXISTS \"${CLAP_SDK_DIR}/include/clap\")\n        message(STATUS \"CLAP seems to be already installed in '${CLAP_SDK_DIR}'.\")\n    else()\n        message(FATAL_ERROR \"There already exists a file or folder named '${CLAP_SDK_DIR}' but it does not seem to contain CLAP.\")\n    endif()\nelse()\n    message(STATUS \"Cloning CLAP to '${CLAP_SDK_DIR}'...\")\n    execute_process(COMMAND git clone --depth=1 --shallow-submodules --single-branch --no-tags --progress --branch 1.1.9 https://github.com/free-audio/clap \"${CLAP_SDK_DIR}\" RESULT_VARIABLE result)\n    if(result)\n        message(FATAL_ERROR \"Cloning repository failed: ${result}\")\n    endif()\nendif()\n"
  },
  {
    "path": "install_JUCE_ARA.cmake",
    "content": "# CMake script to install the JUCE_ARA repository right next to the script,\n# or to a custom location provided via JUCE_ARA_DIR.\n#\n# See README.md and NOTICE.txt for details.\n#\n# THIS SOFTWARE IS PROVIDED BY CELEMONY SOFTWARE GMBH AND CONTRIBUTORS \"AS IS\"\n# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n# IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n# PARTICULAR PURPOSE ARE DISCLAIMED.\n# IN NO EVENT SHALL CELEMONY SOFTWARE GMBH AND/OR CONTRIBUTORS BE LIABLE FOR\n# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\n# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\n# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\ncmake_minimum_required(VERSION 3.19 FATAL_ERROR)\n\nif(NOT JUCE_ARA_DIR)\n    set(JUCE_ARA_DIR \"${CMAKE_CURRENT_LIST_DIR}/JUCE_ARA\")\nendif()\n\nif(EXISTS \"${JUCE_ARA_DIR}\")\n    if(EXISTS \"${JUCE_ARA_DIR}/modules/juce_audio_plugin_client/ARA\")\n        message(STATUS \"JUCE ARA seems to be already installed in '${JUCE_ARA_DIR}'.\")\n    else()\n        message(FATAL_ERROR \"There already exists a file or folder named ${JUCE_ARA_DIR} but it does not seem to contain JUCE ARA.\")\n    endif()\nelse()\n    message(STATUS \"Cloning JUCE ARA to '${JUCE_ARA_DIR}'...\")\n    execute_process(COMMAND git clone --depth=20 --shallow-submodules --single-branch --no-tags --progress --branch 7.0.3 https://github.com/Celemony/JUCE_ARA \"${JUCE_ARA_DIR}\" RESULT_VARIABLE result)\n    if(result)\n        message(FATAL_ERROR \"Cloning repository failed: ${result}\")\n    endif()\nendif()\n\nmessage(STATUS \"Install complete. Now build and launch the Projucer found in '${JUCE_ARA_DIR}/extras/Projucer/Builds',\")\nmessage(STATUS \"choose Open Example > Plugins > ARAPluginDemo and export the project for your IDE of choice.\")\n"
  },
  {
    "path": "install_vst3sdk.cmake",
    "content": "# CMake script to install a subset of the Steinberg VST3 SDK right next to the script,\n# or to a custom location provided by VST3_SDK_DIR.\n#\n# See README.md and NOTICE.txt for details.\n#\n# THIS SOFTWARE IS PROVIDED BY CELEMONY SOFTWARE GMBH AND CONTRIBUTORS \"AS IS\"\n# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n# IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A\n# PARTICULAR PURPOSE ARE DISCLAIMED.\n# IN NO EVENT SHALL CELEMONY SOFTWARE GMBH AND/OR CONTRIBUTORS BE LIABLE FOR\n# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\n# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\n# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\ncmake_minimum_required(VERSION 3.19 FATAL_ERROR)\n\nif(NOT VST3_SDK_DIR)\n    set(VST3_SDK_DIR \"${CMAKE_CURRENT_LIST_DIR}/vst3sdk\")\nendif()\n\nif(EXISTS \"${VST3_SDK_DIR}\")\n    if(EXISTS \"${VST3_SDK_DIR}/cmake/modules/SMTG_VST3_SDK.cmake\")\n        message(STATUS \"VST3 SDK seems to be already installed in '${VST3_SDK_DIR}'.\")\n    else()\n        message(FATAL_ERROR \"There already exists a file or folder named ${VST3_SDK_DIR} but it does not seem to contain the VST3 SDK.\")\n    endif()\nelse()\n    message(STATUS \"Cloning VST3 SDK to '${VST3_SDK_DIR}'...\")\n    execute_process(COMMAND git clone --depth=1 --shallow-submodules --single-branch --no-tags --progress --branch v3.7.11_build_10 https://github.com/steinbergmedia/vst3sdk.git \"${VST3_SDK_DIR}\" RESULT_VARIABLE result)\n    if(result)\n        message(FATAL_ERROR \"Cloning repository failed: ${result}\")\n    endif()\n\n    message(STATUS \"Initializing VST3 SDK submodules...\")\n    execute_process(COMMAND git -C \"${VST3_SDK_DIR}\" submodule update --init --depth=1 --single-branch --progress -- base cmake pluginterfaces public.sdk RESULT_VARIABLE result)\n    if(result)\n        message(FATAL_ERROR \"Initializing submodules failed: ${result}\")\n    endif()\nendif()\n"
  }
]