Add install instructions to README, flatten release zip structure

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: tucktuckg00se

.github/workflows/release.yml

@@ -21,7 +21,10 @@ jobs:
 
       - name: Package
         run: |
-          7z a INTERSECT-Windows.zip ./build/Intersect_artefacts/Release/VST3/INTERSECT.vst3 ./build/Intersect_artefacts/Release/Standalone/INTERSECT.exe
+          mkdir staging
+          cp -r build/Intersect_artefacts/Release/VST3/INTERSECT.vst3 staging/
+          cp build/Intersect_artefacts/Release/Standalone/INTERSECT.exe staging/
+          cd staging && 7z a ../INTERSECT-Windows.zip *
 
       - uses: actions/upload-artifact@v4
         with:
@@ -48,7 +51,10 @@ jobs:
 
       - name: Package
         run: |
-          zip -r INTERSECT-Linux.zip build/Intersect_artefacts/Release/VST3/INTERSECT.vst3 build/Intersect_artefacts/Release/Standalone/INTERSECT
+          mkdir staging
+          cp -r build/Intersect_artefacts/Release/VST3/INTERSECT.vst3 staging/
+          cp build/Intersect_artefacts/Release/Standalone/INTERSECT staging/
+          cd staging && zip -r ../INTERSECT-Linux.zip .
 
       - uses: actions/upload-artifact@v4
         with:
@@ -70,7 +76,11 @@ jobs:
 
       - name: Package
         run: |
-          zip -r INTERSECT-macOS.zip build/Intersect_artefacts/Release/VST3/INTERSECT.vst3 build/Intersect_artefacts/Release/Standalone/INTERSECT.app build/Intersect_artefacts/Release/AU/INTERSECT.component
+          mkdir staging
+          cp -r build/Intersect_artefacts/Release/VST3/INTERSECT.vst3 staging/
+          cp -r build/Intersect_artefacts/Release/Standalone/INTERSECT.app staging/
+          cp -r build/Intersect_artefacts/Release/AU/INTERSECT.component staging/
+          cd staging && zip -r ../INTERSECT-macOS.zip .
 
       - uses: actions/upload-artifact@v4
         with:

README.md

@@ -22,6 +22,48 @@ A time-stretching intersecting sample slicer plugin with independent per-slice p
 - **Full state recall** — all parameters, slices, and audio data saved/restored with the DAW session
 - **Dark industrial theme** — styled popup menus and controls
 
+## Install
+
+Download the latest release zip for your platform from the [Releases](https://github.com/tucktuckg00se/INTERSECT/releases) page and extract it.
+
+### Windows
+
+Copy `INTERSECT.vst3` to your VST3 folder:
+
+```
+C:\Program Files\Common Files\VST3\
+```
+
+Or run `INTERSECT.exe` as a standalone app.
+
+### macOS
+
+Copy `INTERSECT.vst3` to your VST3 folder:
+
+```
+~/Library/Audio/Plug-Ins/VST3/
+```
+
+For AU, copy `INTERSECT.component` to:
+
+```
+~/Library/Audio/Plug-Ins/Components/
+```
+
+Or run `INTERSECT.app` as a standalone app.
+
+### Linux
+
+Copy `INTERSECT.vst3` to your VST3 folder:
+
+```
+~/.vst3/
+```
+
+Or run the `INTERSECT` standalone binary directly.
+
+After installing, rescan plugins in your DAW to pick up INTERSECT.
+
 ## Build
 
 Requires CMake 3.22+ and a C++20 compiler.