# Floppy Verifier - User Manual (macOS)
# Tralegraffe Software Solution
# Version 26.04 — Copyright (c) 2026 Tralegraffe Software Solution

---

## ENGLISH

### Description
Floppy Verifier is a tool by Tralegraffe Software Solution for testing and verifying 3.5" floppy disks using a Greaseweazle USB adapter on macOS. Two scripts are provided:

- **floppy144.sh** — Tests PC-format 1.44MB HD (High Density) floppy disks.
- **floppy880.sh** — Tests Amiga-format 880KB DD (Double Density) floppy disks.

Each script performs a full write/read/compare cycle: it erases the disk, writes a blank image in the appropriate format, reads it back, and compares the result to verify the floppy is still functional.

### Activation
This software requires a free one-time activation per device. On first launch, you will be asked for your name and email address. An internet connection is required for the activation process. Once activated, the license is lifetime and no further activation is needed on the same device.

### Features
1. Full erase → write → read → compare verification cycle
2. Automatic Greaseweazle device detection
3. Progress bar with elapsed/remaining time
4. Detailed logs saved for each disk tested
5. Batch mode: test multiple disks in a row without relaunching
6. Color-coded pass/fail results

### Requirements
- macOS 10.13+ (High Sierra or later)
- Greaseweazle USB adapter connected
- Greaseweazle `gw` command-line tool installed (default path: `~/Library/Python/3.9/bin/gw`)
- `curl` (preinstalled on macOS)
- Internet connection (first activation only)

### Installation
1. Install Greaseweazle: `pip3 install greaseweazle`
2. Connect the Greaseweazle adapter via USB
3. Connect a 3.5" floppy drive to the Greaseweazle
4. Make the script executable: `chmod +x floppy144.sh` or `chmod +x floppy880.sh`

### Usage
1. Run the script: `./floppy144.sh` (for PC 1.44MB) or `./floppy880.sh` (for Amiga 880KB)
2. On first run, follow the activation prompt (name + email)
3. Insert a floppy disk and press ENTER
4. The script will:
   - Verify the Greaseweazle device is connected
   - Erase all tracks on the floppy
   - Write a blank image in the correct format
   - Read the image back from the floppy
   - Compare written vs read data
5. Result: ✅ FLOPPY OK or ❌ VERIFICA FALLITA (with reason)
6. Insert another floppy and press ENTER, or type `q` to quit

### Custom Greaseweazle Path
If your `gw` binary is in a non-default location, set the `GW_BIN` environment variable:
```
GW_BIN=/path/to/gw ./floppy144.sh
```

### Logs
All logs and disk images are saved in:
- PC 1.44MB: `~/greaseweazle_logs/`
- Amiga 880KB: `~/greaseweazle_amiga_logs/`

### License
Copyright (c) 2026 Tralegraffe Software Solution.
Distributed under the MIT License. See the LICENSE file for full terms.

---

## ITALIANO

### Descrizione
Floppy Verifier è uno strumento di Tralegraffe Software Solution per testare e verificare i floppy disk da 3.5 pollici utilizzando un adattatore USB Greaseweazle su macOS. Sono forniti due script:

- **floppy144.sh** — Testa floppy in formato PC 1.44MB HD (Alta Densità).
- **floppy880.sh** — Testa floppy in formato Amiga 880KB DD (Doppia Densità).

Ogni script esegue un ciclo completo di scrittura/lettura/confronto: cancella il disco, scrive un'immagine vuota nel formato appropriato, la rilegge e confronta il risultato per verificare che il floppy sia ancora funzionante.

### Attivazione
Questo software richiede un'attivazione gratuita una tantum per dispositivo. Al primo avvio verranno richiesti nome, cognome e indirizzo email. È necessaria una connessione internet per il processo di attivazione. Una volta attivato, la licenza è lifetime e non sarà necessaria alcuna ulteriore attivazione sullo stesso dispositivo.

### Funzionalità
1. Ciclo completo di verifica: cancellazione → scrittura → lettura → confronto
2. Rilevamento automatico dispositivo Greaseweazle
3. Barra di avanzamento con tempo trascorso/residuo
4. Log dettagliati salvati per ogni disco testato
5. Modalità batch: testa più dischi di fila senza rilanciare
6. Risultati colorati pass/fail

### Requisiti
- macOS 10.13+ (High Sierra o successivo)
- Adattatore USB Greaseweazle collegato
- Tool a linea di comando `gw` di Greaseweazle installato (percorso default: `~/Library/Python/3.9/bin/gw`)
- `curl` (preinstallato su macOS)
- Connessione internet (solo per la prima attivazione)

### Installazione
1. Installa Greaseweazle: `pip3 install greaseweazle`
2. Collega l'adattatore Greaseweazle via USB
3. Collega un floppy drive da 3.5" al Greaseweazle
4. Rendi lo script eseguibile: `chmod +x floppy144.sh` oppure `chmod +x floppy880.sh`

### Utilizzo
1. Esegui lo script: `./floppy144.sh` (per PC 1.44MB) o `./floppy880.sh` (per Amiga 880KB)
2. Al primo avvio, segui la procedura di attivazione (nome + email)
3. Inserisci un floppy disk e premi INVIO
4. Lo script:
   - Verifica che il Greaseweazle sia collegato
   - Cancella tutte le tracce del floppy
   - Scrive un'immagine vuota nel formato corretto
   - Rilegge l'immagine dal floppy
   - Confronta i dati scritti con quelli letti
5. Risultato: ✅ FLOPPY OK oppure ❌ VERIFICA FALLITA (con motivo)
6. Inserisci un altro floppy e premi INVIO, oppure digita `q` per uscire

### Percorso Greaseweazle personalizzato
Se il binario `gw` si trova in un percorso non standard, imposta la variabile d'ambiente `GW_BIN`:
```
GW_BIN=/percorso/verso/gw ./floppy144.sh
```

### Log
Tutti i log e le immagini disco vengono salvati in:
- PC 1.44MB: `~/greaseweazle_logs/`
- Amiga 880KB: `~/greaseweazle_amiga_logs/`

### Licenza
Copyright (c) 2026 Tralegraffe Software Solution.
Distribuito sotto licenza MIT. Consulta il file LICENSE per i termini completi.

---

For support, contact: castle.ox@icloud.com