0.31.3

Author: atkAudioUser

.gitignore

@@ -1,5 +1,6 @@
-# Exclude everything
+# ignore everything
 /*
+/.*
 
 # Except for default project files
 !/.github
@@ -25,17 +26,3 @@
 
 !/lib
 !.vscode
-
-# Exclude lock files
-*.lock.json
-
-# Exclude macOS legacy resource forks
-.DS_Store
-
-
-
-# Exclude generated packages
-/packages
-
-# Exclude dependency cache (now in build directories)
-/.deps

CMakeLists.txt

@@ -22,48 +22,27 @@ include(helpers)
 file(READ "${CMAKE_SOURCE_DIR}/buildspec.json" buildspec)
 string(JSON QT6_VERSION GET ${buildspec} dependencies qt6 version)
 
-# Define architecture-specific dependency directory in the build directory
-# Use CMAKE_BINARY_DIR so it works with any configured build directory
-set(DEPS_DIR "${CMAKE_BINARY_DIR}/obs-deps")
+# Persistent dependency directory (survives cache clears)
+if(WIN32)
+    set(DEPS_DIR "${CMAKE_SOURCE_DIR}/_deps/${CMAKE_VS_PLATFORM_NAME}")
+else()
+    set(DEPS_DIR "${CMAKE_SOURCE_DIR}/_deps")
+endif()
 
-# Configure Qt paths for cross-compilation on Windows
+# Qt paths for Windows builds
 if(WIN32)
     if(CMAKE_VS_PLATFORM_NAME STREQUAL "ARM64")
-        # ARM64 Cross-compilation setup
-        set(QT_HOST_PATH "${DEPS_DIR}/obs-deps-qt6-${QT6_VERSION}-x64")
-        set(Qt6_DIR "${DEPS_DIR}/obs-deps-qt6-${QT6_VERSION}-ARM64/lib/cmake/Qt6" CACHE STRING "Qt6 ARM64 CMake directory" FORCE)
-        
-        message(STATUS "ARM64 Cross-compilation detected")
-        message(STATUS "QT_HOST_PATH: ${QT_HOST_PATH}")
-        message(STATUS "Qt6_DIR: ${Qt6_DIR}")
-        
-        # Check if x64 Qt host tools exist
-        if(EXISTS "${QT_HOST_PATH}/bin/moc.exe")
-            message(STATUS "Found x64 Qt host tools at: ${QT_HOST_PATH}")
-        else()
-            message(FATAL_ERROR "x64 Qt host tools not found at: ${QT_HOST_PATH}. ARM64 cross-compilation requires both x64 and ARM64 Qt dependencies.")
-        endif()
-        
-        # Set Qt host tools for cross-compilation (use x64 tools for ARM64 builds)
-        set(Qt6CoreTools_DIR "${QT_HOST_PATH}/lib/cmake/Qt6CoreTools" CACHE STRING "Qt6 x64 Core Tools" FORCE)
-        set(Qt6GuiTools_DIR "${QT_HOST_PATH}/lib/cmake/Qt6GuiTools" CACHE STRING "Qt6 x64 GUI Tools" FORCE)
-        set(Qt6WidgetsTools_DIR "${QT_HOST_PATH}/lib/cmake/Qt6WidgetsTools" CACHE STRING "Qt6 x64 Widget Tools" FORCE)
-        
-        # Explicitly set tool executables that AUTOMOC/AUTOUIC/AUTORCC will use
-        set(CMAKE_AUTOMOC_MOC_EXECUTABLE "${QT_HOST_PATH}/bin/moc.exe" CACHE FILEPATH "MOC executable for ARM64 cross-compilation" FORCE)
-        set(CMAKE_AUTOUIC_UIC_EXECUTABLE "${QT_HOST_PATH}/bin/uic.exe" CACHE FILEPATH "UIC executable for ARM64 cross-compilation" FORCE)
-        set(CMAKE_AUTORCC_RCC_EXECUTABLE "${QT_HOST_PATH}/bin/rcc.exe" CACHE FILEPATH "RCC executable for ARM64 cross-compilation" FORCE)
-        
-        # Also set the legacy variables for compatibility
-        set(QT_MOC_EXECUTABLE "${QT_HOST_PATH}/bin/moc.exe")
-        set(QT_RCC_EXECUTABLE "${QT_HOST_PATH}/bin/rcc.exe")
-        set(QT_UIC_EXECUTABLE "${QT_HOST_PATH}/bin/uic.exe")
-        
-        message(STATUS "Set CMAKE_AUTOMOC_MOC_EXECUTABLE to: ${CMAKE_AUTOMOC_MOC_EXECUTABLE}")
+        # ARM64 cross-compilation: use x64 Qt tools with ARM64 libraries
+        set(QT_HOST_PATH "${CMAKE_SOURCE_DIR}/_deps/x64/obs-deps-qt6-${QT6_VERSION}-x64")
+        set(Qt6_DIR "${DEPS_DIR}/obs-deps-qt6-${QT6_VERSION}-ARM64/lib/cmake/Qt6" CACHE PATH "" FORCE)
+        set(Qt6CoreTools_DIR "${QT_HOST_PATH}/lib/cmake/Qt6CoreTools" CACHE PATH "" FORCE)
+        set(Qt6GuiTools_DIR "${QT_HOST_PATH}/lib/cmake/Qt6GuiTools" CACHE PATH "" FORCE)
+        set(Qt6WidgetsTools_DIR "${QT_HOST_PATH}/lib/cmake/Qt6WidgetsTools" CACHE PATH "" FORCE)
+        set(CMAKE_AUTOMOC_MOC_EXECUTABLE "${QT_HOST_PATH}/bin/moc.exe" CACHE FILEPATH "" FORCE)
+        set(CMAKE_AUTOUIC_UIC_EXECUTABLE "${QT_HOST_PATH}/bin/uic.exe" CACHE FILEPATH "" FORCE)
+        set(CMAKE_AUTORCC_RCC_EXECUTABLE "${QT_HOST_PATH}/bin/rcc.exe" CACHE FILEPATH "" FORCE)
     else()
-        # x64 build - set paths to x64 Qt
-        set(Qt6_DIR "${DEPS_DIR}/obs-deps-qt6-${QT6_VERSION}-x64/lib/cmake/Qt6" CACHE STRING "Qt6 x64 CMake directory" FORCE)
-        message(STATUS "x64 build detected - using x64 Qt at: ${Qt6_DIR}")
+        set(Qt6_DIR "${DEPS_DIR}/obs-deps-qt6-${QT6_VERSION}-x64/lib/cmake/Qt6" CACHE PATH "" FORCE)
     endif()
 endif()
 

CMakePresets.json

@@ -14,6 +14,16 @@
         "ENABLE_FRONTEND_API": true
       }
     },
+    {
+      "name": "ci-template",
+      "hidden": true,
+      "environment": {
+        "CI": "true"
+      },
+      "cacheVariables": {
+        "CMAKE_COMPILE_WARNING_AS_ERROR": false
+      }
+    },
     {
       "name": "ubuntu-cross-compile-template",
       "hidden": true,
@@ -64,13 +74,13 @@
     {
       "name": "macos-ci",
       "inherits": [
-        "macos"
+        "macos",
+        "ci-template"
       ],
       "displayName": "macOS Universal CI build",
       "description": "Build for macOS 12.0+ (Universal binary) for CI",
       "generator": "Xcode",
       "cacheVariables": {
-        "CMAKE_COMPILE_WARNING_AS_ERROR": false,
         "CMAKE_OSX_DEPLOYMENT_TARGET": "12.0"
       }
     },
@@ -100,13 +110,11 @@
     {
       "name": "windows-ci-x64",
       "inherits": [
-        "windows-x64"
+        "windows-x64",
+        "ci-template"
       ],
       "displayName": "Windows x64 CI build",
-      "description": "Build for Windows x64 on CI",
-      "cacheVariables": {
-        "CMAKE_COMPILE_WARNING_AS_ERROR": false
-      }
+      "description": "Build for Windows x64 on CI"
     },
     {
       "name": "windows-arm64",
@@ -134,13 +142,11 @@
     {
       "name": "windows-ci-arm64",
       "inherits": [
-        "windows-arm64"
+        "windows-arm64",
+        "ci-template"
       ],
       "displayName": "Windows ARM64 CI build",
-      "description": "Build for Windows ARM64 on CI",
-      "cacheVariables": {
-        "CMAKE_COMPILE_WARNING_AS_ERROR": false
-      }
+      "description": "Build for Windows ARM64 on CI"
     },
     {
       "name": "ubuntu-x86_64",
@@ -169,14 +175,11 @@
     {
       "name": "ubuntu-ci-x86_64",
       "inherits": [
-        "ubuntu-x86_64"
+        "ubuntu-x86_64",
+        "ci-template"
       ],
       "displayName": "Ubuntu x86_64 CI build",
-      "description": "Build for Ubuntu x86_64 on CI",
-      "cacheVariables": {
-        "CMAKE_BUILD_TYPE": "RelWithDebInfo",
-        "CMAKE_COMPILE_WARNING_AS_ERROR": false
-      }
+      "description": "Build for Ubuntu x86_64 on CI"
     }
   ],
   "buildPresets": [
@@ -201,13 +204,6 @@
       "description": "Windows build for x64",
       "configuration": "RelWithDebInfo"
     },
-    {
-      "name": "windows-x64-release",
-      "configurePreset": "windows-x64",
-      "displayName": "Windows x64 Release",
-      "description": "Windows build for x64",
-      "configuration": "Release"
-    },
     {
       "name": "windows-ci-x64",
       "configurePreset": "windows-ci-x64",
@@ -222,13 +218,6 @@
       "description": "Windows build for ARM64",
       "configuration": "RelWithDebInfo"
     },
-    {
-      "name": "windows-arm64-release",
-      "configurePreset": "windows-arm64",
-      "displayName": "Windows ARM64 Release",
-      "description": "Windows build for ARM64",
-      "configuration": "Release"
-    },
     {
       "name": "windows-ci-arm64",
       "configurePreset": "windows-ci-arm64",

README.md

@@ -32,9 +32,19 @@ Develop your own audio processing plugins and integrate them into `PluginHost2`
 
 ## Audio Source Mixer (OBS Source)
 
-- Mix audio from up to 8 OBS sources into a new OBS audio source
-- E.g. allows creating new submixes
-- Can be used as 'dummy' source to host Device IO
+- Mix audio from OBS sources into a new OBS audio source
+- Can be used as 'dummy' source to host filters, e.g. PluginHost2
+
+## Usage examples
+
+- Use Delay filter to manually delay/sync individual audio sources
+- Source Mixer can create submixes (or one main mix) from multiple OBS audio sources
+  - Mute original sources to prevent double/parallel audio
+- Use DeviceIo2 to route audio directly between OBS and audio devices (e.g. ASIO)
+- Put CPU intensive plugins into PluginHost and enable MT for better performance (multi-core, one buffer extra latency)
+- Use a sampler plugin with a MIDI keyboard in PluginHost as a soundboard
+- Do all of the above and more with PluginHost2
+  - MIDI control of OBS audio source volume & mute
 
 ## Build instructions
 

buildspec.json

@@ -47,6 +47,6 @@
   "uuids": {
     "windowsApp": "ad885c58-5ca9-44de-8f4f-1c12676626a9"
   },
-  "version": "0.31.2",
+  "version": "0.31.3",
   "website": "https://www.atkaudio.com"
 }

cmake/macos/buildspec.cmake

@@ -11,8 +11,8 @@ function(_check_dependencies_macos)
 
   file(READ "${CMAKE_CURRENT_SOURCE_DIR}/buildspec.json" buildspec)
 
-  # Use build-directory-specific dependency directory
-  set(dependencies_dir "${CMAKE_BINARY_DIR}/obs-deps")
+  # Use source-directory-based dependency directory to persist across cache clears
+  set(dependencies_dir "${CMAKE_SOURCE_DIR}/_deps")
   set(prebuilt_filename "macos-deps-VERSION-ARCH_REVISION.tar.xz")
   set(prebuilt_destination "obs-deps-VERSION-ARCH")
   set(qt6_filename "macos-deps-qt6-VERSION-ARCH-REVISION.tar.xz")
@@ -23,10 +23,9 @@ function(_check_dependencies_macos)
 
   _check_dependencies()
 
+  # Remove quarantine flags from downloaded dependencies (ignore errors on read-only git pack files)
   execute_process(
-    COMMAND "xattr" -r -d com.apple.quarantine "${dependencies_dir}"
-    RESULT_VARIABLE result
-    COMMAND_ERROR_IS_FATAL ANY
+    COMMAND bash -c "find '${dependencies_dir}' -not -path '*/.git/*' -exec xattr -d com.apple.quarantine {} \\; 2>/dev/null || true"
   )
 
   list(APPEND CMAKE_FRAMEWORK_PATH "${dependencies_dir}/Frameworks")

cmake/windows/buildspec.cmake

@@ -9,8 +9,8 @@ function(_check_dependencies_windows)
   set(arch ${CMAKE_VS_PLATFORM_NAME})
   set(platform windows-${arch})
 
-  # Use build-directory-specific dependency directories to avoid conflicts
-  set(dependencies_dir "${CMAKE_BINARY_DIR}/obs-deps")
+  # Use source-directory-based dependency directory to persist across cache clears
+  set(dependencies_dir "${CMAKE_SOURCE_DIR}/_deps/${arch}")
   set(prebuilt_filename "windows-deps-VERSION-ARCH-REVISION.zip")
   set(prebuilt_destination "obs-deps-VERSION-ARCH")
   set(qt6_filename "windows-deps-qt6-VERSION-ARCH-REVISION.zip")
@@ -34,8 +34,8 @@ endfunction()
 function(_download_x64_qt_for_arm64)
   set(arch "x64")
   set(platform "windows-x64")
-  # Store x64 tools in the build deps directory for cross-compilation
-  set(dependencies_dir "${CMAKE_BINARY_DIR}/obs-deps")
+  # Store x64 tools in a persistent deps directory for cross-compilation
+  set(dependencies_dir "${CMAKE_SOURCE_DIR}/_deps/x64")
   set(qt6_filename "windows-deps-qt6-VERSION-ARCH-REVISION.zip")
   set(qt6_destination "obs-deps-qt6-VERSION-ARCH")
   set(dependencies_list qt6)

lib/atkaudio/CMakeLists.txt

@@ -17,13 +17,15 @@ set(target ${PROJECT_NAME})
 # Always use JUCE modules only (no helper tools)
 set(JUCE_MODULES_ONLY ON CACHE BOOL "Only build JUCE modules" FORCE)
 
+# Store FetchContent downloads in _deps to persist across cache clears
+set(FETCHCONTENT_BASE_DIR "${CMAKE_SOURCE_DIR}/_deps" CACHE PATH "" FORCE)
+
 include(FetchContent)
 FetchContent_Declare(
     juce
     EXCLUDE_FROM_ALL
     GIT_REPOSITORY https://github.com/juce-framework/JUCE.git
-    GIT_TAG        master
-    GIT_SHALLOW    TRUE
+    GIT_TAG        230340dbfc580628596243bb63b31aeb4d6b5a6d  # develop 2025-11-27
 )
 FetchContent_MakeAvailable(juce)
 # _juce_initialise_target(${target} ${target})
@@ -52,6 +54,8 @@ target_compile_definitions(
     JUCE_MODAL_LOOPS_PERMITTED=1 # we use QT event loop, so this is needed
     # Disable DBG() output in CI/GitHub Actions RelWithDebInfo builds (keeps debug symbols but no console spam in CI)
     $<$<AND:$<CONFIG:RelWithDebInfo>,$<OR:$<BOOL:$ENV{CI}>,$<BOOL:$ENV{GITHUB_ACTIONS}>>>:JUCE_DISABLE_ASSERTIONS>
+    # SIMULATE_UPDATE_CHECK # Uncomment to test update dialog without network
+    SIMULATE_UPDATE_CHECK # Testing update dialog
 )
 
 set_target_properties(${PROJECT_NAME} PROPERTIES
@@ -91,42 +95,25 @@ if(NOT WIN32)
         )
 endif()
 
-# ASIO SDK is only needed on Windows
+# ASIO SDK (Windows only)
 if(WIN32)
-    set(ASIO_SDK_URL "https://www.steinberg.net/asiosdk")
-    set(ASIO_SDK_TEMPDIR "${CMAKE_CURRENT_BINARY_DIR}/asiosdk_temp")
-    set(ASIO_SDK_DIR "${CMAKE_CURRENT_BINARY_DIR}/asiosdk")
-
+    set(ASIO_SDK_DIR "${CMAKE_SOURCE_DIR}/_deps/asiosdk")
     if(NOT EXISTS "${ASIO_SDK_DIR}")
+        set(_asio_zip "${CMAKE_SOURCE_DIR}/_deps/asiosdk.zip")
+        set(_asio_temp "${CMAKE_SOURCE_DIR}/_deps/asiosdk_temp")
         message(STATUS "Downloading ASIO SDK...")
-        file(DOWNLOAD "${ASIO_SDK_URL}" "${CMAKE_CURRENT_BINARY_DIR}/asiosdk.zip"
-            STATUS download_status
-            SHOW_PROGRESS
-        )
-        if(download_status)
-            message(STATUS "Extracting ASIO SDK...")
-            file(ARCHIVE_EXTRACT 
-                INPUT "${CMAKE_CURRENT_BINARY_DIR}/asiosdk.zip"
-                DESTINATION "${ASIO_SDK_TEMPDIR}"
-            )
-            file(GLOB ASIO_SDK_DIRS "${ASIO_SDK_TEMPDIR}/*")
-            foreach(dir ${ASIO_SDK_DIRS})
-                if(IS_DIRECTORY ${dir} AND dir MATCHES ".*asiosdk.*")
-                message(STATUS "ASIO SDK extracted to ${dir}")
-                file(RENAME ${dir} ${ASIO_SDK_DIR})
-                break()
-                endif()
-            endforeach()
+        file(DOWNLOAD "https://www.steinberg.net/asiosdk" "${_asio_zip}" STATUS _status SHOW_PROGRESS)
+        list(GET _status 0 _code)
+        if(_code EQUAL 0)
+            file(ARCHIVE_EXTRACT INPUT "${_asio_zip}" DESTINATION "${_asio_temp}")
+            file(GLOB _dirs "${_asio_temp}/*")
+            list(GET _dirs 0 _extracted)
+            file(RENAME "${_extracted}" "${ASIO_SDK_DIR}")
+            file(REMOVE_RECURSE "${_asio_temp}" "${_asio_zip}")
+            message(STATUS "ASIO SDK installed to ${ASIO_SDK_DIR}")
         endif()
     endif()
-
-    target_include_directories(
-        ${PROJECT_NAME}
-        PRIVATE
-            ${CMAKE_CURRENT_BINARY_DIR}/asiosdk/common
-    )
-
-    target_include_directories(${PROJECT_NAME} PRIVATE "${ASIO_SDK_DIR}")
+    target_include_directories(${PROJECT_NAME} PRIVATE "${ASIO_SDK_DIR}/common")
 endif()
 
 if(WIN32)
@@ -142,4 +129,4 @@ endif()
 
 target_compile_definitions(${PROJECT_NAME} PRIVATE JUCE_ASIO=1)
 
-file(COPY_FILE ${CMAKE_SOURCE_DIR}/LICENSE ${CMAKE_BINARY_DIR}/INSTALLER-LICENSE)
+file(COPY_FILE ${CMAKE_SOURCE_DIR}/LICENSE ${CMAKE_BINARY_DIR}/INSTALLER-LICENSE)

lib/atkaudio/cmake/cpack.cmake

@@ -295,6 +295,7 @@ set(CPACK_NSIS_DISPLAY_NAME "${DISPLAYNAME}")
 set(CPACK_NSIS_UNINSTALL_NAME "Uninstall ${DISPLAYNAME}")
 set(CPACK_NSIS_INSTALL_ROOT "$COMMONPROGRAMDATA\\obs-studio\\plugins")
 set(CPACK_NSIS_BRANDING_TEXT " ")
+set(CPACK_NSIS_COMPRESSOR "zlib")
 file(TO_NATIVE_PATH "${CPACK_NSIS_INSTALL_ROOT}" CPACK_NSIS_INSTALL_ROOT)
 string(REPLACE "\\" "\\\\" CPACK_NSIS_INSTALL_ROOT "${CPACK_NSIS_INSTALL_ROOT}")