# WebP Exporter (cwebp) – v1.2.0
Plugin per Lightroom Classic di Marco De Maio
https://www.marcodemaio.it/webp-lightroom-classic-export-plugin/

============================================================
INSTALLAZIONE
============================================================

1. Copia la cartella LightroomWebPExport.lrplugin in una
   posizione stabile sul tuo computer:

   macOS:   ~/Documents/Lightroom/Plugins/
   Windows: C:\Users\<nome>\Documents\Lightroom\Plugins\

2. In Lightroom:
   File > Plugin Manager > Add > seleziona la cartella
   LightroomWebPExport.lrplugin

3. Installa cwebp (vedi sezione INSTALLARE CWEBP sotto)

4. In Export, scegli "WebP (cwebp)" come destinazione

5. Clicca "▶ Test cwebp" nel pannello Export per verificare
   che tutto funzioni prima di esportare

============================================================
INSTALLARE CWEBP
============================================================

Il plugin ha bisogno del programma "cwebp" di Google per
convertire le foto in formato WebP.

── macOS ──────────────────────────────────────────────────

Opzione A – Binario nel plugin (CONSIGLIATA, nessuna
configurazione, funziona subito):

  Scarica il pacchetto per il tuo Mac da:
  https://developers.google.com/speed/webp/docs/precompiled

  • Se hai un Mac con Apple Silicon (M1/M2/M3/M4):
    scarica:  libwebp-x.x.x-mac-arm64.tar.gz
    estrai il file "cwebp" dalla cartella bin/
    copialo in:
    LightroomWebPExport.lrplugin/bin/mac/arm64/cwebp

  • Se hai un Mac con Intel:
    scarica:  libwebp-x.x.x-mac-x86-64.tar.gz
    estrai il file "cwebp" dalla cartella bin/
    copialo in:
    LightroomWebPExport.lrplugin/bin/mac/x86_64/cwebp

  Poi apri il Terminale e lancia questi comandi
  (adatta il percorso alla tua posizione):

  chmod +x .../bin/mac/arm64/cwebp
  chmod +x .../bin/mac/x86_64/cwebp
  xattr -d com.apple.quarantine .../bin/mac/arm64/cwebp
  xattr -d com.apple.quarantine .../bin/mac/x86_64/cwebp

  Puoi mettere solo la versione per il tuo Mac se preferisci.
  Il plugin rileva automaticamente l'architettura.

Opzione B – Percorso manuale:
  Imposta il percorso completo in:
  Export > WebP Settings > cwebp executable path
  poi clicca "▶ Test cwebp" per verificare.

── Windows ────────────────────────────────────────────────

Opzione A – Binario nel plugin (CONSIGLIATA, nessuna
configurazione, funziona subito):

  Scarica il pacchetto Windows da:
  https://developers.google.com/speed/webp/docs/precompiled

  Cerca: libwebp-x.x.x-windows-x64.zip
  Estrai il file "cwebp.exe" dalla cartella bin/
  Copialo in:
  LightroomWebPExport.lrplugin\bin\win\cwebp.exe

Opzione B – Percorso manuale:
  Imposta il percorso completo in:
  Export > WebP Settings > cwebp executable path
  Esempio: C:\Tools\WebP\bin\cwebp.exe

============================================================
STRUTTURA CARTELLE PLUGIN
============================================================

LightroomWebPExport.lrplugin/
├── Info.lua
├── ExportDialog.lua
├── WebPExportServiceProvider.lua
├── README.txt
└── bin/
    ├── mac/
    │   ├── arm64/
    │   │   └── cwebp      ← Mac Apple Silicon (M1/M2/M3/M4)
    │   └── x86_64/
    │       └── cwebp      ← Mac Intel
    └── win/
        └── cwebp.exe      ← Windows

Il plugin rileva automaticamente quale versione usare.
Non è necessario configurare nulla se i file sono al posto
giusto.

============================================================
COME VERIFICARE CHE TUTTO FUNZIONI
============================================================

1. Apri Lightroom
2. File > Export
3. Scegli "WebP (cwebp)" come destinazione
4. Clicca il pulsante "▶ Test cwebp"

Se vedi ✅ sei pronto ad esportare.
Se vedi ❌ segui le istruzioni nel messaggio di errore.

============================================================
LOG DI DIAGNOSTICA
============================================================

Il plugin crea automaticamente un file di log nella stessa
cartella dove esporti le immagini:

  webp-export-log.txt

Questo file è utile se qualcosa non funziona: contiene
tutte le informazioni necessarie per capire il problema.

Il log include:
  • Versione plugin, OS, versione Lightroom
  • Data e ora dell'export
  • Quale cwebp è stato trovato e dove
  • Risultato per ogni foto (OK / errore + motivo)
  • Riepilogo finale (totale, successi, errori, saltate)

Per un log ancora più dettagliato:
  Attiva "Debug mode" nel pannello Export.
  Il log includerà anche il comando esatto eseguito,
  il return code e la dimensione del file generato.

In caso di problemi, invia il file webp-export-log.txt
alla pagina del plugin per ricevere supporto:
https://www.marcodemaio.it/webp-lightroom-classic-export-plugin/

============================================================
OPZIONI DI EXPORT
============================================================

Encoding mode    Lossy / Lossless / Near-lossless
Quality          0–100 (lossy e lossless hint)
Near-lossless    0–100 (0 = massima riduzione qualità)
Lossless level   0–9  (6 = default)
Preset           photo / picture / drawing / icon / text / default
Method           0–6  (4 = default, 6 = migliore qualità/più lento)
Multi-thread     Abilita -mt per encoding più veloce
Metadata         none / icc / exif / xmp / icc,exif,xmp / all
Color space      sRGB / Adobe RGB / ProPhoto RGB
Delete TIFF      Elimina il TIFF intermedio dopo la conversione
                 (disattiva per tenerlo, utile per debug)
Debug mode       Log esteso nella cartella di export

============================================================
PROBLEMI COMUNI
============================================================

"cwebp non trovato" / ❌ nel Test
  → Controlla di aver messo cwebp nella cartella giusta
  → Controlla di aver eseguito chmod +x e xattr (macOS)
  → Oppure imposta il percorso manualmente nel pannello Export

"Export completato con X errori"
  → Controlla webp-export-log.txt nella cartella di export
  → Attiva Debug mode e riesporta per un log più dettagliato
  → Invia il log alla pagina del plugin per supporto

Windows: il file .webp non viene creato
  → Controlla che cwebp.exe sia in bin\win\cwebp.exe
  → Controlla che il percorso non contenga caratteri speciali
  → Controlla che l'antivirus non blocchi cwebp.exe
  → Attiva Debug mode e controlla il log

macOS: "non è possibile aprire cwebp perché non è verificato"
  → Esegui dal Terminale:
    xattr -d com.apple.quarantine /percorso/a/cwebp

============================================================
CHANGELOG
============================================================

v1.2.0
  - Supporto binari separati per Mac arm64 e x86_64
  - Rilevamento automatico architettura Mac (Apple Silicon / Intel)
  - UI separata in ExportDialog.lua
  - Windows: wrapper cmd.exe /c per esecuzione affidabile
  - Windows: quoting robusto per path con spazi e Unicode
  - Validazione output su esistenza file (non solo return code)
  - resolveCwebp migliorato con tracciamento sorgente
  - Log diagnostica completo nella cartella di export
  - Modalità Debug mode (log verboso per foto)
  - Pulsante "▶ Test cwebp" nel pannello export
  - Opzione "Delete intermediate TIFF" esplicita
  - Firma autore con link cliccabile nel pannello export

v1.1.3
  - Fixed Windows command execution/quoting for cwebp path
  - Accepts pasted paths with surrounding quotes
  - Windows PATH fallback uses where cwebp

v1.1.0
  - Added near-lossless mode
  - Added metadata options
  - macOS Homebrew path auto-detection

v1.0.0
  - First public release
