← Tutti i progetti
Attivo novembre 2026

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.

C#.NETAvaloniamacOSWindowsOpen source

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

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:

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