From 450a34d8034b2d147f538f4ba93bbe1a7b41fa43 Mon Sep 17 00:00:00 2001
From: Alex Birch <Birch-san@users.noreply.github.com>
Date: Sun, 10 Jun 2018 11:27:19 +0100
Subject: [PATCH] add installation instructions. prevent double-copy of
 licenses. skip build if targets are missing.

---
 Builds/MacOSX/archive-for-distribution.sh | 23 +++++++++---
 Builds/MacOSX/how to install.txt          | 45 +++++++++++++++++++++++
 2 files changed, 62 insertions(+), 6 deletions(-)
 create mode 100644 Builds/MacOSX/how to install.txt

diff --git a/Builds/MacOSX/archive-for-distribution.sh b/Builds/MacOSX/archive-for-distribution.sh
index ecb7268..b63c9c3 100755
--- a/Builds/MacOSX/archive-for-distribution.sh
+++ b/Builds/MacOSX/archive-for-distribution.sh
@@ -24,12 +24,23 @@ trap 'error ${LINENO}' ERR
 declare -a BUILDS=("Debug" "Release")
 for BUILD in "${BUILDS[@]}"
 do
-	if [ -d "$MYDIR/build/$BUILD" ]; then
-		echo "Found $BUILD; archiving targets to build/$BUILD.tar.xz:"
-		ls "$MYDIR/build/$BUILD"
-    \cp -rf ../../LICENSE.txt "$MYDIR/build/$BUILD/LICENSE.txt"
-    \cp -rf ../../licenses_of_dependencies "$MYDIR/build/$BUILD/licenses_of_dependencies"
-		tar -hczf "$MYDIR/build/$BUILD.tar.xz" -C "$MYDIR/build/$BUILD" .
+  BUILDDIR="$MYDIR/build/$BUILD"
+	if [ -d "$BUILDDIR" ]; then
+    echo "Found build $BUILD"
+    if [[ -d "$BUILDDIR/juicysfplugin.app" \
+    && -d "$BUILDDIR/juicysfplugin.component" \
+    && -d "$BUILDDIR/juicysfplugin.vst" \
+    && -d "$BUILDDIR/juicysfplugin.vst3" ]]; then
+      echo "Found in $BUILD all targets: .app, .component, .vst, .vst3"
+      echo "Archiving $BUILD targets to build/$BUILD.tar.xz:"
+      ls "$BUILDDIR"
+      \cp -rf "$MYDIR/how to install.txt" "$BUILDDIR/how to install.txt"
+      \cp -rf "$MYDIR/../../LICENSE.txt" "$BUILDDIR/LICENSE.txt"
+      \cp -rf "$MYDIR/../../licenses_of_dependencies" "$BUILDDIR/."
+      tar -hczf "$BUILDDIR.tar.xz" --exclude="libjuicysfplugin.a" -C "$MYDIR/build/$BUILD" .
+    else
+      echo "Did not find in $BUILD all targets: .app, .component, .vst, .vst3; skipping."
+    fi
 	else
 		echo "Missing $BUILD; skipping."
 	fi
diff --git a/Builds/MacOSX/how to install.txt b/Builds/MacOSX/how to install.txt
new file mode 100644
index 0000000..6bc2640
--- /dev/null
+++ b/Builds/MacOSX/how to install.txt	
@@ -0,0 +1,45 @@
+Release contains:
+
+```
+juicysfplugin.app        # standalone application, for playing around
+juicysfplugin.component  # AU plugin
+juicysfplugin.vst        # VST plugin
+juicysfplugin.vst3       # VST3 plugin
+```
+
+====
+
+To install plugins, move them to the following folder:
+
+```
+juicysfplugin.component -> ~/Library/Audio/Plug-Ins/Components/juicysfplugin.component
+juicysfplugin.vst       -> ~/Library/Audio/Plug-Ins/VST/juicysfplugin.vst
+juicysfplugin.vst3      -> ~/Library/Audio/Plug-Ins/VST3/juicysfplugin.vst3
+```
+
+If the folder `~/Library/Audio/Plug-Ins/VST` (or Components, or VST3) does not yet exist, make the folder yourself.
+
+A handy way to get to the folder `~/Library/Audio/Plug-Ins/` is to open Finder and use the "Go" keyboard shortcut:  
+⌘ + ⇧ + G
+
+====
+
+To install juicysfplugin.app, put it wherever you want (for example /Applications or ~/Applications).
+
+If you cannot open juicysfplugin.app, try _right-clicking_ it, and choose Open from the right-click menu. This gives you a _different dialogue_, with a new option, "Open".
+
+====
+
+Here's some soundfonts to get you started:
+
+- MuseScore's recommended soundfonts (includes MIT, GPL, other licenses)
+  - https://musescore.org/en/handbook/soundfonts-and-sfz-files#list
+- FlameStudios' guitar soundfonts (GPL-licensed)
+  - http://www.flamestudios.org/free/Soundfonts
+
+
+====
+
+Full instructions here:
+
+https://github.com/Birch-san/juicysfplugin/blob/master/README.md
\ No newline at end of file