openframeworks · danoli3 · Aug 5, 2026 · Aug 6, 2026
diff --git a/scripts/android/download_libs.sh b/scripts/android/download_libs.sh
@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Platform-clean removes only lib/android; other platforms stay installed.
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-cd $SCRIPT_DIR
-../dev/download_libs.sh -p android -b $@
+cd "$SCRIPT_DIR"
+../dev/download_libs.sh -p android -b "$@"
diff --git a/scripts/dev/download_libs.sh b/scripts/dev/download_libs.sh
@@ -4,11 +4,12 @@ VER=latest
 PLATFORM=""
 ARCH=""
 OVERWRITE=1
+FULL_CLEAN=0
 LEGACY=0
 SILENT_ARGS=""
 NO_SSL=""
 BLEEDING_EDGE=0
-DL_VERSION=2.7.1
+DL_VERSION=2.7.2
 TAG=""
 
 printHelp(){
@@ -25,8 +26,12 @@ cat << EOF
                                     msys2: 64
                                     android: armv7, arm64, and x86 (if not specified will download all)
                                     linux: 64gcc6, armv6l or armv7l
-    -n, --no-overwrite          Merge new libraries with existing ones, use only to download same version for different platforms
-                                If not set deletes any existing libraries
+    -n, --no-overwrite          Pure merge: do not delete anything before extract.
+                                Default (without -n) only removes libs/<lib>/lib/\$PLATFORM so other
+                                platforms (android + ios + macos + emscripten …) can coexist.
+    --full-clean                Also remove shared include/ (and bin/ for vs|msys2) for libs being
+                                installed. Use for a hard reset of one platform install; not needed
+                                for multi-platform side-by-side installs.
     -s, --silent                Silent download progress
     -h, --help                  Shows this message
     -k, --no-ssl                Allow no SSL validation
@@ -107,6 +112,10 @@ while [[ $# -gt 0 ]]; do
         -n|--no-overwrite)
         OVERWRITE=0
         ;;
+        --full-clean)
+        FULL_CLEAN=1
+        OVERWRITE=1
+        ;;
         -b|--bleeding-edge)
         BLEEDING_EDGE=1
         ;;
@@ -350,31 +359,49 @@ download "${PKGS[@]}"
 
 cd ../ # back to libs
 libs=("cairo" "curl" "FreeImage" "brotli" "fmod" "freetype" "glew" "glfw" "json" "libpng" "openssl" "pixman" "poco" "rtAudio" "tess2" "uriparser" "utf8" "videoInput" "zlib" "opencv" "ippicv" "assimp" "libxml2" "svgtiny" "fmt")
+
+# Resolve which lib/<name> folder this package uses.
+# Apple multi-target packages (macos, and ios/tvos/… wrappers that pass -p macos)
+# install under lib/macos/*.xcframework. Plain "osx" may use lib/osx and/or a
+# macos-arm64_x86_64 slice — never wipe the whole lib/macos tree for -p osx.
+LIB_PLATFORM_DIR="$PLATFORM"
+case "$PLATFORM" in
+    ios|tvos|xros|catos|watchos|macos) LIB_PLATFORM_DIR="macos" ;;
+esac
+
 if [ $OVERWRITE -eq 1 ]; then
     echo " "
-    echo " Overwrite - Removing prior libraries for [$PLATFORM]"
+    if [ $FULL_CLEAN -eq 1 ]; then
+        echo " Full-clean - Removing platform libs + shared include/bin for [$PLATFORM]"
+    else
+        echo " Platform-clean - Removing prior libs only under lib/[$LIB_PLATFORM_DIR] (other platforms kept)"
+    fi
     for ((i=0;i<${#libs[@]};++i)); do
-        if [ -e "${libs[i]}/lib/$PLATFORM" ]; then
-            echo "  Removing: [${libs[i]}/lib/$PLATFORM]"
-            rm -rf "${libs[i]}/lib/$PLATFORM"
+        if [ -e "${libs[i]}/lib/$LIB_PLATFORM_DIR" ]; then
+            echo "  Removing: [${libs[i]}/lib/$LIB_PLATFORM_DIR]"
+            rm -rf "${libs[i]}/lib/$LIB_PLATFORM_DIR"
         fi
-        if [ "$PLATFORM" == "msys2" ] || [ "$PLATFORM" == "vs" ]; then
-            if [ -e "${libs[i]}/bin" ]; then
-                echo "  Removing: [${libs[i]}/bin]"
-                rm -rf "${libs[i]}/bin"
+        # Shared include/ + vs|msys2 bin/ only with --full-clean (not for multi-platform installs)
+        if [ $FULL_CLEAN -eq 1 ]; then
+            if [ "$PLATFORM" == "msys2" ] || [ "$PLATFORM" == "vs" ]; then
+                if [ -e "${libs[i]}/bin" ]; then
+                    echo "  Removing: [${libs[i]}/bin]"
+                    rm -rf "${libs[i]}/bin"
+                fi
+            fi
+            if [ -e "${libs[i]}/include" ]; then
+                echo "  Removing: [${libs[i]}/include]"
+                rm -rf "${libs[i]}/include"
             fi
         fi
-        if [ -e "${libs[i]}/include" ]; then
-            echo "  Removing: [${libs[i]}/include]"
-            rm -rf "${libs[i]}/include"
-        fi
-
     done
 fi
 
+# osx host packages may also refresh the desktop slice inside lib/macos/*.xcframework
+# without deleting ios/tvos/… sibling slices in the same xcframework.
 if [ "$PLATFORM" == "osx" ]; then
     echo " "
-    echo " Overwrite - Removing prior libraries for [$PLATFORM]"
+    echo " xcframework - refresh macos host slice (ios/tvos/… slices kept)"
     for ((i=0;i<${#libs[@]};++i)); do
         xcframework_path="${libs[i]}/lib/macos/${libs[i]}.xcframework/macos-arm64_x86_64"
         if [ $OVERWRITE -eq 1 ]; then
@@ -385,7 +412,16 @@ if [ "$PLATFORM" == "osx" ]; then
         fi
         info_plist_path="${libs[i]}/lib/macos/${libs[i]}.xcframework/Info.plist"
         if [ -e "$info_plist_path" ]; then
-            #echo "  Backing up: [${info_plist_path}] to [${info_plist_path}.bak]"
+            cp "$info_plist_path" "${info_plist_path}.bak"
+        fi
+    done
+elif [ "$PLATFORM" == "macos" ]; then
+    # Full lib/macos already cleared above when OVERWRITE=1; only need Info.plist backup if merge
+    echo " "
+    echo " xcframework - macos multi-target package (lib/macos)"
+    for ((i=0;i<${#libs[@]};++i)); do
+        info_plist_path="${libs[i]}/lib/macos/${libs[i]}.xcframework/Info.plist"
+        if [ -e "$info_plist_path" ]; then
             cp "$info_plist_path" "${info_plist_path}.bak"
         fi
     done
@@ -457,36 +493,47 @@ fi
 echo "   ------ "
 if [ "$PLATFORM" == "osx" ]; then
     if [ $OVERWRITE -eq 1 ]; then
-        echo " Overwrite - addon xCFramework: [${addons[i]} - ${addonslibs[i]}]"
-        xcframework_path="../addons/${addons[i]}/libs/${addonslibs[i]}/lib/macos/${addonslibs[i]}.xcframework/macos-arm64_x86_64"
-        if [ -e "$xcframework_path" ]; then
-            echo "  Removing: [$xcframework_path]"
-            rm -rf "$xcframework_path"
-        fi
-    fi
-    info_plist_path="../addons/${addons[i]}/libs/${addonslibs[i]}/lib/macos/${addonslibs[i]}.xcframework/Info.plist"
-    if [ -e "$info_plist_path" ]; then
-        cp "$info_plist_path" "${info_plist_path}.bak"
+        # Refresh desktop slice only — keep ios/tvos/… slices in the same xcframework
+        for ((i=0;i<${#addonslibs[@]};++i)); do
+            xcframework_path="../addons/${addons[i]}/libs/${addonslibs[i]}/lib/macos/${addonslibs[i]}.xcframework/macos-arm64_x86_64"
+            if [ -e "$xcframework_path" ]; then
+                echo "  Removing addon host slice: [$xcframework_path]"
+                rm -rf "$xcframework_path"
+            fi
+            info_plist_path="../addons/${addons[i]}/libs/${addonslibs[i]}/lib/macos/${addonslibs[i]}.xcframework/Info.plist"
+            if [ -e "$info_plist_path" ]; then
+                cp "$info_plist_path" "${info_plist_path}.bak"
+            fi
+        done
     fi
+elif [ "$PLATFORM" == "macos" ]; then
+    for ((i=0;i<${#addonslibs[@]};++i)); do
+        info_plist_path="../addons/${addons[i]}/libs/${addonslibs[i]}/lib/macos/${addonslibs[i]}.xcframework/Info.plist"
+        if [ -e "$info_plist_path" ]; then
+            cp "$info_plist_path" "${info_plist_path}.bak"
+        fi
+    done
 fi
 
 
-if [ $OVERWRITE -eq 1 ]; then 
+if [ $OVERWRITE -eq 1 ]; then
     for ((i=0;i<${#addonslibs[@]};++i)); do
         if [ -e ${addonslibs[i]} ] ; then
 
-            echo " Overwrite - addon: [${addons[i]} - ${addonslibs[i]}]"
-            if [ -e ../addons/${addons[i]}/libs/${addonslibs[i]}/lib/$PLATFORM ]; then
-                echo "   Remove binaries: [${addons[i]}/libs/${addonslibs[i]}/lib/$PLATFORM]"
-                rm -rf ../addons/${addons[i]}/libs/${addonslibs[i]}/lib/$PLATFORM
-            fi
-            if [ -e ../addons/${addons[i]}/libs/${addonslibs[i]}/bin ]; then
-                echo "   Remove binaries: [${addons[i]}/libs/${addonslibs[i]}/bin]"
-                rm -rf ../addons/${addons[i]}/libs/${addonslibs[i]}/bin
+            echo " Platform-clean - addon: [${addons[i]} - ${addonslibs[i]}] → lib/$LIB_PLATFORM_DIR"
+            if [ -e ../addons/${addons[i]}/libs/${addonslibs[i]}/lib/$LIB_PLATFORM_DIR ]; then
+                echo "   Remove binaries: [${addons[i]}/libs/${addonslibs[i]}/lib/$LIB_PLATFORM_DIR]"
+                rm -rf ../addons/${addons[i]}/libs/${addonslibs[i]}/lib/$LIB_PLATFORM_DIR
             fi
-            if [ -e ../addons/${addons[i]}/libs/${addonslibs[i]}/include ]; then
-                echo "   Remove include: [${addons[i]}/libs/include]"
-                rm -rf ../addons/${addons[i]}/libs/${addonslibs[i]}/include
+            if [ $FULL_CLEAN -eq 1 ]; then
+                if [ -e ../addons/${addons[i]}/libs/${addonslibs[i]}/bin ]; then
+                    echo "   Remove binaries: [${addons[i]}/libs/${addonslibs[i]}/bin]"
+                    rm -rf ../addons/${addons[i]}/libs/${addonslibs[i]}/bin
+                fi
+                if [ -e ../addons/${addons[i]}/libs/${addonslibs[i]}/include ]; then
+                    echo "   Remove include: [${addons[i]}/libs/${addonslibs[i]}/include]"
+                    rm -rf ../addons/${addons[i]}/libs/${addonslibs[i]}/include
+                fi
             fi
         fi
     done

diff --git a/scripts/dev/lib_sources.sh b/scripts/dev/lib_sources.sh
@@ -133,6 +133,12 @@ downloadApothecaryLibs(){
 	else
 		args+=( -b )
 	fi
+	# LIB_CLEAN_MODE: platform (default) | merge (-n) | full (--full-clean)
+	case "${LIB_CLEAN_MODE:-platform}" in
+		merge|no-overwrite|n) args+=( -n ) ;;
+		full|full-clean)      args+=( --full-clean ) ;;
+		platform|*)           ;; # default platform-scoped clean in download_libs.sh
+	esac
 	"$script" "${args[@]}"
 }
 
@@ -188,18 +194,33 @@ downloadOfLibs(){
 		rm -rf "${tmp}/extract"
 		mkdir -p "${tmp}/extract" "$dest"
 		unzip -qo "${dlDir}/${pkg}" -d "${tmp}/extract"
+		# Merge into libs/<name> so other platforms under lib/<platform>/ are kept.
+		# Headers are shared and replaced; only this package's lib/* children are replaced.
 		if [[ -d "${tmp}/extract/include" ]]; then
-			rm -rf "${dest}/include"
-			mv "${tmp}/extract/include" "${dest}/include"
+			mkdir -p "${dest}/include"
+			if command -v rsync &>/dev/null; then
+				rsync -a --delete "${tmp}/extract/include/" "${dest}/include/"
+			else
+				rm -rf "${dest}/include"
+				mv "${tmp}/extract/include" "${dest}/include"
+			fi
 		fi
 		if [[ -d "${tmp}/extract/lib" ]]; then
-			rm -rf "${dest}/lib"
-			mv "${tmp}/extract/lib" "${dest}/lib"
+			mkdir -p "${dest}/lib"
+			# Replace only platform subdirs present in the package (e.g. lib/macos, lib/android)
+			local child
+			for child in "${tmp}/extract/lib"/*; do
+				[[ -e "$child" ]] || continue
+				local base
+				base=$(basename "$child")
+				rm -rf "${dest}/lib/${base}"
+				mv "$child" "${dest}/lib/${base}"
+			done
 		fi
 		[[ -f "${tmp}/extract/copying.txt" ]] && cp "${tmp}/extract/copying.txt" "${dest}/" 2>/dev/null || true
 		ok=$((ok + 1))
 	done
-	echo " ofLibs install complete  ok=${ok}  skipped=${skip}  (libs/<lib>/{include,lib})"
+	echo " ofLibs install complete  ok=${ok}  skipped=${skip}  (libs/<lib>/{include,lib/<platform>})"
 	echo " note: ofLibs is ofWorks-oriented; stock oF may need path tweaks for some libs."
 	[[ $ok -gt 0 ]]
 }

diff --git a/scripts/emscripten/download_libs.sh b/scripts/emscripten/download_libs.sh
@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
-
+# Platform-clean removes only lib/emscripten; other platforms stay installed.
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-cd $SCRIPT_DIR
+cd "$SCRIPT_DIR"
 
 if [ ! -z ${BITS+x} ]; then
-    ../dev/download_libs.sh -p emscripten -b -a $BITS $@
+    ../dev/download_libs.sh -p emscripten -b -a $BITS "$@"
 else
-    ../dev/download_libs.sh -p emscripten -b -n $@
+    ../dev/download_libs.sh -p emscripten -b "$@"
 fi
diff --git a/scripts/ios/download_libs.sh b/scripts/ios/download_libs.sh
@@ -1,9 +1,10 @@
 #!/usr/bin/env bash
+# Apple multi-target xcframeworks ship as the "macos" package (ios · tvos · … slices).
+# Platform-clean only touches lib/macos; other platforms (android, emscripten, …) are kept.
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-cd $SCRIPT_DIR
-cd $SCRIPT_DIR
+cd "$SCRIPT_DIR"
 if [ ! -z ${BITS+x} ]; then
-    ../dev/download_libs.sh -p macos -b -a $BITS -n $@
+    ../dev/download_libs.sh -p macos -b -a $BITS "$@"
 else
-    ../dev/download_libs.sh -p macos -b -n $@
+    ../dev/download_libs.sh -p macos -b "$@"
 fi
diff --git a/scripts/linux/download_libs.sh b/scripts/linux/download_libs.sh
@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Platform-clean removes only lib/linux; other platforms stay installed.
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-cd $SCRIPT_DIR
-../dev/download_libs.sh -p linux -b $@
+cd "$SCRIPT_DIR"
+../dev/download_libs.sh -p linux -b "$@"
diff --git a/scripts/macos/download_libs.sh b/scripts/macos/download_libs.sh
@@ -1,10 +1,11 @@
 #!/usr/bin/env bash
-
+# Downloads Apple multi-target package → lib/macos/*.xcframework
+# Default clean is platform-scoped (lib/macos only); pass --full-clean for include wipe.
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-cd $SCRIPT_DIR
+cd "$SCRIPT_DIR"
 
 if [ ! -z ${BITS+x} ]; then
-    ../dev/download_libs.sh -p macos -b -a $BITS $@
+    ../dev/download_libs.sh -p macos -b -a $BITS "$@"
 else
-    ../dev/download_libs.sh -p macos -b -n $@
+    ../dev/download_libs.sh -p macos -b "$@"
 fi
diff --git a/scripts/msys2/download_libs.sh b/scripts/msys2/download_libs.sh
@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
+# Platform-clean removes only lib/msys2; shared include/bin need --full-clean.
 SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-cd $SCRIPT_DIR
+cd "$SCRIPT_DIR"
 
-../dev/download_libs.sh -p msys2 -b $@
+../dev/download_libs.sh -p msys2 -b "$@"