From 5c60a38ff156ac259172b5468d2117bc6fc5df01 Mon Sep 17 00:00:00 2001
From: luciano <info@zappacosta.eu>
Date: Fri, 19 Jun 2026 16:28:06 +0200
Subject: [PATCH] Release packaging: unsigned mac DMG build +
 install/security-bypass docs

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 RELEASE.md                   | 58 ++++++++++++++++++++++++++++++++++++
 package.json                 |  3 +-
 scripts/fix-security.command | 11 +++++++
 3 files changed, 71 insertions(+), 1 deletion(-)
 create mode 100644 RELEASE.md
 create mode 100755 scripts/fix-security.command

diff --git a/RELEASE.md b/RELEASE.md
new file mode 100644
index 0000000..ecf88e3
--- /dev/null
+++ b/RELEASE.md
@@ -0,0 +1,58 @@
+# Installazione su Mac — DJ Visualizer
+
+L'app è distribuita come **DMG non firmato con un certificato Apple** (non c'è
+un account sviluppatore a pagamento). È **ad-hoc firmata**, quindi funziona, ma
+al primo avvio macOS la blocca per sicurezza (Gatekeeper). Ecco come installarla
+e sbloccarla.
+
+## 1. Installare
+
+1. Apri il file **`DJ Visualizer-1.0.0-arm64.dmg`**.
+2. Trascina **DJ Visualizer** nella cartella **Applicazioni**.
+
+## 2. Sbloccare la sicurezza (Gatekeeper)
+
+Al primo avvio può comparire *«DJ Visualizer non può essere aperto perché Apple
+non può verificare…»* oppure *«…è danneggiata e non può essere aperta»*.
+Scegli **uno** di questi metodi.
+
+### Metodo A — Apri col tasto destro (il più semplice)
+1. In **Applicazioni**, **clic destro** (o Ctrl+clic) su **DJ Visualizer**.
+2. Scegli **Apri**.
+3. Nella finestra che appare, premi di nuovo **Apri**.
+
+Da quel momento si apre normalmente con un doppio clic.
+
+### Metodo B — Da Impostazioni di Sistema
+1. Prova ad aprire l'app (verrà bloccata).
+2. Vai in **Impostazioni di Sistema ▸ Privacy e Sicurezza**.
+3. In fondo, accanto a *«DJ Visualizer è stata bloccata…»*, premi **Apri comunque**.
+
+### Metodo C — Terminale (se compare "è danneggiata")
+Questo errore appare quando il file è stato scaricato (attributo "quarantena").
+Apri il **Terminale** e incolla:
+
+```bash
+xattr -cr "/Applications/DJ Visualizer.app"
+```
+
+Poi apri l'app normalmente. In alternativa è incluso lo script
+**`scripts/fix-security.command`**: doppio clic per eseguirlo.
+
+> Nota: questi passaggi servono **solo la prima volta**. Sono necessari perché
+> l'app non è notarizzata da Apple (serve un Apple Developer Program a pagamento).
+
+## 3. Permessi richiesti dall'app
+
+- **Microfono / Ingresso audio** — per l'input live e per catturare l'audio di
+  sistema (BlackHole). macOS lo chiede al primo uso; concedilo.
+- **Registrazione schermo** — *non* richiesta: l'app registra il proprio canvas,
+  non lo schermo.
+
+## Ricompilare il DMG
+
+```bash
+npm install
+CSC_IDENTITY_AUTO_DISCOVERY=false npm run dist
+```
+Il DMG viene creato in `dist/`.
diff --git a/package.json b/package.json
index 82f83dc..e4fb10c 100644
--- a/package.json
+++ b/package.json
@@ -19,7 +19,8 @@
     "mac": {
       "category": "public.app-category.music",
       "target": "dmg",
-      "icon": "build/icon.icns"
+      "icon": "build/icon.icns",
+      "identity": null
     },
     "files": [
       "main.js",
diff --git a/scripts/fix-security.command b/scripts/fix-security.command
new file mode 100755
index 0000000..7364e38
--- /dev/null
+++ b/scripts/fix-security.command
@@ -0,0 +1,11 @@
+#!/bin/bash
+# Rimuove l'attributo di quarantena così DJ Visualizer si apre senza errori.
+APP="/Applications/DJ Visualizer.app"
+if [ -d "$APP" ]; then
+  xattr -cr "$APP"
+  echo "✅ Fatto! Ora puoi aprire DJ Visualizer dalle Applicazioni."
+else
+  echo "⚠️  Prima trascina DJ Visualizer nella cartella Applicazioni, poi riesegui."
+fi
+echo "Premi Invio per chiudere."
+read