← Tutti i progetti
Attivo novembre 2026

MassiveRenamer

Un programma per rinominare molti file in una volta su Windows e macOS, ispirato a Lupas Rename (solo Windows, fermo al 2004): regole combinabili, anteprima con i problemi segnalati prima di toccare niente, e un annulla che funziona anche dopo aver chiuso il programma.

PythonPySide6QtmacOSWindowsOpen source

Il problema

Prima o poi capita a tutti: cento foto che si chiamano IMG_4821.jpg, una stagione di una serie con i nomi in disordine, una cartella di documenti dove le maiuscole sono a caso. Rinominarli a mano è un incubo; rinominarli con un programma è un’altra cosa, se il programma è bravo. Esiste Lupas Rename, un classico gratuito per Windows, che però esiste solo lì e non viene aggiornato dal 2004. Per il Mac non c’è niente di equivalente, e allora ne ho fatto uno per entrambi: MassiveRenamer.

Cosa fa

Le regole si combinano, si vedono subito sull’anteprima e si applicano tutte insieme. Ogni gruppo ha la sua casella nel titolo: se è spenta non fa nulla e i suoi campi sono disattivati, ma i valori restano. Dopo una rinomina riuscita tutte le caselle si spengono, così il gruppo di file successivo non eredita una regola per sbaglio:

Una barra del percorso sopra l’elenco mostra la cartella da cui vengono i file e si può scrivere a mano, con il completamento delle cartelle, per passare a un’altra. Nell’anteprima le parti del nuovo nome che cambiano sono evidenziate, e l’ordine si può stabilire a mano (le frecce spostano i file selezionati).

I file si aggiungono anche trascinandoli, e l’elenco si può filtrare di nuovo o svuotare senza ricominciare, con un filtro (*.jpg;*.png), le sottocartelle e i file nascosti a scelta; l’ordine conta, perché la numerazione lo segue, e i numeri nei nomi si ordinano come numeri (img2 prima di img10).

Prima di rinominare, l’anteprima dice tutto

Il vero lavoro di un programma di questo tipo non è rinominare: è non rovinare niente. Per questo l’anteprima segnala, prima di fare qualunque cosa: nomi duplicati, file che esistono già, caratteri che il sistema non ammette, nomi riservati di Windows, nomi vuoti. Un file esistente non viene mai sovrascritto.

Due passaggi per i casi difficili

Rinominare a in b e b in a sembra innocuo, ma se lo si fa un file alla volta il primo passo sovrascrive il secondo. Allo stesso modo, passare da foto.jpg a FOTO.JPG su Windows e su Mac è un caso insidioso, perché il sistema considera i due nomi lo stesso file. La soluzione è fare gli spostamenti in due passaggi, attraverso nomi temporanei: prima tutti vanno in un nome neutro, poi ognuno va al suo nome finale. Così gli scambi e i cambi di sole maiuscole funzionano.

Un annulla che sopravvive

Le ultime rinomine vengono scritte su disco, quindi si possono annullare anche dopo aver chiuso il programma, e ora per più livelli (le ultime venti). Per chi preferisce un’altra strada, c’è l’esportazione di uno script (.bat su Windows, .sh su Mac) che rifà la rinomina, insieme a quello che la disfa. Le regole si salvano e si ricaricano da un file, e le ultime usate sono nel menu File.

Come è fatto

Un progetto in Python con l’interfaccia in Qt (PySide6), in italiano e in inglese, scelti dal menu Lingua. La parte che conta, il motore (regole, anteprima, rinomina, annulla, script), non dipende dall’interfaccia, ed è coperta dai test. Gli eseguibili si creano con PyInstaller; un Mac non può costruire quello per Windows, quindi lo fa la CI, che li produce per Windows, Mac Apple Silicon e Mac Intel a ogni modifica. Come per GBFileCopier, il branch principale è protetto: si lavora su un branch a parte, si apre una richiesta di integrazione e si fonde solo con i controlli verdi su tutte e tre le piattaforme; ci sono anche gli aggiornamenti automatici delle dipendenze e i controlli sui segreti.

Si aggiorna da solo, ma solo se glielo permetti

Dal 29 ottobre il programma sa aggiornarsi. Al primo avvio una barra chiede se controllare ogni giorno le novità: finché non rispondo di sì, non contatta nessuno. Se c’è una versione più recente propone «Installa e riavvia». Il meccanismo è lo stesso che ho scritto per GBFileCopier, con le stesse cautele: il file si scarica solo dalla pagina dei rilasci del progetto e deve avere l’hash indicato nel file dei checksum. Su Windows il nuovo programma prende il posto di quello in uso (il vecchio diventa un file da cancellare al prossimo avvio); su Mac si controlla la versione dell’app scaricata e uno script la sostituisce dopo la chiusura, rimettendo la vecchia se qualcosa va storto. Da sorgente, o in una cartella dove non si può scrivere, il pulsante si limita ad aprire la pagina del rilascio. Un tag di versione su GitHub, che deve coincidere con quella scritta nel codice, fa partire la build e pubblica il rilascio.

Il tasto destro, e una finestra sola

Mancava il modo di raggiungere il programma da dove i file già sono. Su Windows aggiunge voci al menu contestuale di file, cartelle e dello sfondo di una cartella; sul Mac, un’azione rapida del Finder. Selezionare tanti file e lanciare il programma più volte non deve aprire tante finestre, quindi ora c’è una istanza unica: il secondo avvio passa i percorsi al primo ed esce. Qui l’integrazione continua ha preso un errore vero: se chi invia non aspettava la conferma del primo, Windows perdeva i percorsi.

Stato

La 0.1.0 è stata pubblicata il 29 ottobre 2026, e la sera stessa la 0.1.1. Una lezione dalla prima: la sua app Mac aveva una firma rotta, perché la versione veniva scritta nel pacchetto dopo la firma, e le copie scaricate risultavano «danneggiate»; le note di rilascio rimandano alla 0.1.1, la prima build Mac firmata e notarizzata. Il 30 ottobre ho fatto quello che mancava: l’aggiornamento automatico vero dalla 0.1.0 alla 0.1.1, a mano, sul Mac e su Windows (rinomina, annulla, aggiornamento), e ha funzionato. Questo significa anche che l’interfaccia su Windows è stata provata da una persona. La 0.2.0, pubblicata lo stesso giorno, ha portato le regole nuove, il menu del tasto destro e l’istanza unica; le voci in Esplora risorse e nelle azioni rapide del Finder non le ho ancora viste con i miei occhi. Il progetto è passato alla licenza GPL-3.0.

Poi è venuto un giro di pulizia. L’interfaccia ha ora i suoi test, eseguiti senza schermo a ogni modifica, con le schermate salvate dalla build. Gli eseguibili sono diventati più leggeri togliendo le parti di Qt che il programma non usa mai: l’app Mac è passata da 104 a 69 MB, quella per Windows da circa 50 a 28. E siccome una libreria mancante si scopre solo all’avvio, la build ora lancia il programma impacchettato con un self-test su ogni piattaforma; una libreria tolta per errore blocca la modifica. Tutto questo, insieme alla barra del percorso, all’ordine manuale e all’annullamento a più livelli, è uscito come 0.3.0 il 31 ottobre, con un’app Mac di 23-26 MB e un eseguibile per Windows di 28. Checksum verificati, app Mac notarizzata.

Il self-test stesso ha insegnato una lezione. Sulla macchina di build con il Mac Intel l’esecuzione si è bloccata per 52 minuti: il servizio di sistema che fornisce le icone lì semplicemente non risponde, e quando la finestra viene attivata Qt aspetta un’icona per sempre. Nel programma non c’era nulla di sbagliato. Ora la build interroga prima quel servizio e, se è morto, salta la parte che ne ha bisogno, lasciando un avviso; il self-test stampa anche i tempi di ogni fase e ha un watchdog di 60 secondi che mostra dove si è fermato.

La 0.4.0, il 31 ottobre, ha portato i veri installer. Su Windows c’è ora un installer per il singolo utente (voce nel menu Start, voce facoltativa del tasto destro e un disinstallatore che toglie anche quella), e la versione in un file unico resta come portatile; una copia installata si aggiorna scaricando l’installer e lanciandolo senza finestre dopo la chiusura del programma. Su Mac c’è un .dmg con l’app e il collegamento ad Applicazioni, firmato e notarizzato. La sua release è fallita una volta: la macchina di build Intel ha perso la rete mentre aspettava la notarizzazione di Apple, quindi ora la notarizzazione controlla l’esito ogni 20 secondi, riprova sugli errori e si arrende solo dopo un’ora. La 0.5.0, il 7 novembre, ha aggiunto le caselle e un’anteprima più leggibile, dopo che avevo visto un contrasto debole sul tema scuro di Windows e un taglio rimasto attivo: colori per tema chiaro e scuro, e le parti cambiate in testo scuro su giallo pieno. La nuova notarizzazione ha funzionato al primo colpo su entrambi i Mac, e ho verificato che l’aggiornamento automatico funziona e che la nuova anteprima si legge meglio. Il percorso di aggiornamento attraverso l’installer di Windows non l’ho confermato, perché non so con certezza quale copia sia stata aggiornata. L’eseguibile per Windows è ancora non firmato.

Chi vuole sostenere il progetto trova una voce nel menu Aiuto, un link nella finestra «Informazioni» e una sezione nel README, con una donazione via PayPal: paypal.me/GiulioBanterla.

Stack

Python · PySide6 (Qt) · PyInstaller · pytest · GitHub Actions · GPL-3.0