GBFileCopier
Un programma libero e open source per copiare file su Windows e macOS, nato da un'idea di TeraCopy: copie verificate leggendo dal disco, nessun file a metà, e una riga di comando oltre alla finestra.
Il problema
Copiare molti file, o file grandi, con il programma di copia del sistema operativo ha un difetto che tutti conoscono: se qualcosa va storto a metà, non sai bene cosa è arrivato e cosa no, e spesso un solo errore blocca tutto. TeraCopy risolve il problema su Windows, ma non c’è niente di equivalente, libero, che funzioni allo stesso modo anche su Mac. Così ho deciso di scriverlo io: GBFileCopier, per Windows e macOS, con licenza GPL.
Cosa fa
- Copia e sposta, con una finestra dove si trascinano file e cartelle, o con una riga di
comando (
gbcopy) per gli script. - Gli errori non fermano il lavoro: i file che falliscono vengono saltati, elencati con il motivo e si possono riprovare.
- Verifica con un checksum, calcolato mentre si copia, con più algoritmi a scelta (da quelli veloci come xxHash ai classici MD5, SHA-1, SHA-256).
- Sposta in sicurezza: un file di origine viene cancellato solo dopo che la copia è stata verificata. Sullo stesso disco lo spostamento è un semplice cambio di nome, quindi istantaneo.
- Conflitti di nome con regole (sovrascrivi, salta, tieni entrambi, solo se più recente), anche per tutti i conflitti successivi.
- Incolla da Finder o Esplora risorse: si copia (o si taglia) un file nel gestore dei file e si incolla nel programma con la combinazione di tasti consueta.
- Pausa e annulla durante le copie lunghe.
- Inglese e italiano, più un tema chiaro, scuro o quello del sistema, che cambia subito senza riavviare.
Una copia onesta
Il cuore del progetto è una domanda semplice: come faccio a sapere che la copia è davvero uguale? Un controllo ingenuo rilegge il file appena scritto, ma il sistema operativo gli risponde dalla memoria cache, dove i dati sono ancora quelli appena scritti: il confronto riesce sempre, anche se il disco ha sbagliato qualcosa. Per questo la verifica usa le funzioni native di ciascun sistema e legge dal disco: su Windows aprendo il file senza buffer, su macOS facendo scartare la cache. Lo stesso vale per il flush dei dati: invece di fidarsi del sistema, si chiede di arrivare fino alla memoria permanente (su Mac il comando che svuota anche la cache interna del disco).
Un’altra regola: ogni file viene scritto con un nome temporaneo nascosto, controllato e solo alla fine rinominato al posto giusto. Una copia interrotta non lascia mai file a metà e non danneggia mai uno esistente.
Come è fatto
Un progetto in C# su .NET 10, con quattro parti: il motore di copia (indipendente dal sistema), uno strato di operazioni native per Windows e macOS, la riga di comando e l’app desktop con Avalonia, la libreria di interfacce che funziona su entrambi. I test girano su Windows e su macOS, Intel e Apple Silicon, con un controllo automatico che nessun testo dell’interfaccia manchi in una lingua e che i segnaposto delle frasi coincidano.
Come lavoro su un progetto che voglio pubblicare
Su questo repository ho chiesto a me stesso più disciplina del solito. Il branch principale è protetto: si lavora su un branch a parte, si apre una richiesta di integrazione, e si fonde solo con i controlli automatici verdi su tutte le piattaforme. Un inciampo istruttivo: ho fuso una richiesta dipendente da un’altra cancellando il branch di base, e GitHub ha chiuso quella dipendente. Ora lo spostamento a monte si fa prima, e solo dopo si cancella.
C’è anche una piccola lezione sui test su Mac: interrogare le finestre con AppleScript ha bloccato tutto in attesa di un permesso che chiedeva a me, e i test dell’interfaccia si fanno ora con immagini renderizzate senza schermo.
Dall’archivio al pacchetto
Un programma che nessuno riesce a installare non esiste. Così ho costruito anche la distribuzione: su Mac un’app unica per Intel e Apple Silicon, impacchettata in un’immagine disco con il collegamento alle Applicazioni; su Windows un installatore (per utente, in inglese e italiano) più una versione portatile. Un solo tag di versione su GitHub fa partire la build di tutto e pubblica un rilascio con i checksum dei file.
La parte che ha richiesto più attenzione è la firma. Fino alla 0.3.0 l’app per Mac aveva solo una firma “ad hoc”, con il solito avviso del sistema; la 0.3.1 è la prima firmata con un certificato di sviluppatore e notarizzata da Apple, e quindi si apre senza avvisi. Per Windows l’installatore non è ancora firmato e il sistema avvisa di un editore sconosciuto. Per Windows avevo scelto il programma SignPath Foundation, gratuito per i progetti open source, perché le alternative erano troppo care (centinaia di euro l’anno), non disponibili ai privati in Europa o comode solo a mano, con un codice da telefono per ogni firma, quindi impossibili in un processo automatico. Ho preparato tutto nel repository e ho inviato la domanda. Il 27 ottobre è stata rifiutata: il programma richiede un progetto già visibile (stelle, contributori, articoli, un’attività nel tempo), e questo ha pochi giorni. Si può ripresentare quando ci sarà, oppure passare a un abbonamento a pagamento, che costa da centinaia a migliaia di dollari l’anno. Ho scelto di restare senza firma su Windows per ora: nel repository e nelle note di rilascio lo dichiaro apertamente, invece di lasciare una frase che prometteva una firma che non c’è. I passaggi per firmare restano nel processo di rilascio, spenti, pronti per quando serviranno.
Integrazione con il sistema
Una copia che si fa solo da un’app a parte vale la metà. Così le versioni successive alla prima hanno aggiunto l’integrazione con i gestori di file:
- Su Mac, un’estensione del Finder (voce nel menu contestuale), il trascinamento sull’icona nel Dock e la possibilità di avere una sola istanza aperta.
- Su Windows, una voce nel menu contestuale di Esplora risorse, la voce “Invia a” e anche lì una sola istanza. (Su Windows 11 la voce sta sotto «Mostra altre opzioni»; il menu moderno richiederebbe un pacchetto firmato.)
Più lavori insieme, e aggiornamenti da sé
Con la 0.4.0 ogni copia o spostamento diventa un lavoro in un elenco: la finestra resta libera per il successivo anche mentre gli altri girano, e le richieste dal Finder o da Esplora risorse non vengono più ignorate durante una copia. I lavori verso lo stesso disco di destinazione vanno uno dopo l’altro, in ordine, mentre quelli verso dischi diversi vanno insieme: inutile far litigare due copie per la stessa testina.
Poi gli aggiornamenti automatici. L’app, al primo avvio, chiede il permesso di controllare le novità; se ce n’è una, propone «Installa e riavvia». Ho scelto di scrivere io il meccanismo invece di usare una libreria, per controllare tutto: scarica dalla pagina dei rilasci, verifica il checksum e la firma, si installa solo se non ci sono lavori in corso. Su Mac un piccolo programma sostituisce l’app e la riavvia, su Windows lancia l’installatore in modo silenzioso. L’ho provato davvero con una versione “finta”, facendo credere all’app di essere più vecchia.
Quando la prudenza costa troppo: copiare su un NAS
Una segnalazione l’ha fatta venire fuori: copiare tanti file piccoli su un NAS andava a 5 MB al
secondo. Ho misurato su una cartella condivisa di casa, con 150 file da 2 MB: 137 secondi con
il flush forzato sul disco dopo ogni file, 27 senza, 22 con il semplice cp del sistema. Il
motivo è che il flush costringe il NAS a scrivere ogni file sui suoi dischi prima di
rispondere, e lo fa un file alla volta; sovrapporre i flush non ha aiutato (da 19 a 14
secondi su 40 file). Così sulle condivisioni di rete il flush per file è ora spento di
default, con una casella nelle impostazioni (e un’opzione nella riga di comando) per
riattivarlo: dove la sicurezza assoluta conta, si sceglie. È la stessa filosofia dell’inizio, ma
applicata con buonsenso: la prudenza vale quando il rischio è reale, non a qualsiasi prezzo.
Sono arrivati anche i dettagli che si notano usandolo: un elenco dei file di ogni lavoro con la loro destinazione mentre girano (prima i risultati si vedevano solo alla fine), la velocità e il tempo rimanente su una riga a parte perché con i nomi lunghi di un NAS venivano tagliati, e su Windows un’opzione per far partire la copia con GBFileCopier già premendo Ctrl+V in Esplora risorse, senza passare dal menu.
Una copia veloce senza perdere la sicurezza, sul Mac
Il Mac ha avuto la sua versione della storia del NAS. Forzare ogni file sulla memoria permanente
costa circa 23 millisecondi sul disco del Mac, qualunque sia la dimensione: copiare duemila file
piccoli richiedeva 44 secondi, contro 1,3 di cp. La soluzione non è togliere la sicurezza ma
darle un prezzo giusto: su Mac ora ogni file riceve una barriera di scrittura (i suoi dati
arrivano sul disco prima di qualunque cosa scritta dopo, quindi il cambio di nome finale non
mostra mai dati che non ci sono) e a fine lavoro un solo flush completo per tutti. Il
risultato: da 44 a 4 secondi su duemila file, da 4 a meno di 1 secondo su centocinquanta file da
2 MB. Su Windows non esiste una barriera equivalente: ho misurato il costo (qualche millisecondo
per file) e l’ho lasciato com’è, perché lì la leva migliore sarebbe copiare più file piccoli in
parallelo.
File piccoli, più alla volta
Quella leva ora è tirata. Ogni file piccolo passa quasi tutto il tempo ad aspettare il file
system (creazione, flush, cambio di nome, date), quindi le serie di file consecutivi sotto i
16 MB si copiano fino a quattro alla volta, mentre un file grande resta da solo, perché già
uno tiene occupato il disco. La parte delicata è stata mantenere le promesse della copia
sequenziale. I risultati tornano nell’ordine del piano, qualunque sia l’ordine di fine delle
copie. I conflitti si risolvono uno alla volta, quindi le finestre arrivano una per volta e
«applica a tutti» vale per i file successivi. E un file e la sua cartella pianificati due volte
si copiano ancora uno dopo l’altro. La revisione ha scovato una trappola vera: con IMG.jpg
già presente, copiare IMG.jpg e un file che si chiama davvero IMG (2).jpg nello stesso
momento faceva volere a entrambi il nome IMG (2).jpg, un falso errore su alcuni file system e
una sovrascrittura silenziosa su altri. Ora i nomi già assegnati sono riservati e la nuova copia
diventa IMG (3).jpg. Sul Mac duemila file minuscoli sono passati da 3,0 a 1,7 secondi, con
copie identiche; non l’ho ancora misurato su un NAS né su Windows, dove dovrebbe contare di più.
File di checksum, per dimostrarlo anche dopo
Verificare subito dopo la copia non è la stessa cosa che poter dimostrare, mesi dopo, che una
cartella è ancora intatta. Così una copia può ora scrivere un file di checksum
nella destinazione, nei formati che capiscono anche altri strumenti (sha256sum, md5, e SFV
per il classico CRC32), e un comando Verifica file di checksum… ne legge uno e segnala i file
diversi o mancanti. La verifica gira come un normale lavoro in coda. La revisione del codice su
entrambi i sistemi ha trovato quello che ci si aspetta da elenchi che passano da una macchina
all’altra: un elenco fatto su Windows ha le barre rovesciate nei percorsi, e un nome con
l’accento può essere salvato in due forme Unicode diverse su un Mac e su un disco NTFS, quindi lo
stesso file non verrebbe trovato. Entrambi i casi sono gestiti, come gli elenchi che non sono in
UTF-8; l’algoritmo si riconosce dal nome del file o dalla lunghezza del checksum, e se il file
non si può scrivere lo strumento a riga di comando esce con un errore. Controllato sul Mac con
shasum, md5 e crc32; gli elenchi scambiati fra Windows e Mac vanno ancora provati sulle
macchine vere.
Stato
Il 19 novembre è uscita la 0.6.1, una versione di sola manutenzione: nessuna novità per chi usa il programma, ma il compilatore è bloccato a una versione esatta nei controlli automatici e nelle build di rilascio, e il processo di rilascio ora fa rivedere tutto il lavoro dall’ultima versione prima di alzare il numero. Un secondo revisore automatico controlla che non finiscano segreti nei push e nei rilasci.
Dalla prima versione alla 0.6.0 in sei giorni (24-30 ottobre 2026): dalle integrazioni con Finder ed Esplora risorse e dalla firma su Mac della 0.3.1, alla coda dei lavori e agli aggiornamenti automatici della 0.4.0, alle rifiniture della 0.4.x, al Ctrl+V di Windows della 0.5.0, alla barriera di scrittura su Mac della 0.5.1, alla copia parallela dei file piccoli e alla voce di donazione nel menu Aiuto della 0.5.2, fino ai file di checksum della 0.6.0. Il 30 ottobre ho provato la 0.5.2 sulle macchine vere e tutto ha funzionato: la copia parallela verso un NAS da Windows, l’aggiornamento dall’interno dell’app (su un PC con il programma nascosto nella barra e sul Mac con l’app nella cartella Applicazioni), l’installazione per tutti gli utenti con la richiesta di amministratore rifiutata, l’avvio all’accesso e la reattività della tastiera durante un lavoro grosso. Windows resta non firmato, e lo dichiaro. Più avanti: il menu moderno di Windows 11, attributi estesi e permessi, cloni istantanei su APFS e rapporti esportabili.
Stack
C# · .NET 10 · Avalonia · GitHub Actions · GPL-3.0