Torna ai progetti

Tool Windows open source · v1.0.0

IP CHANGER

Un tool Windows per cambiare la configurazione IPv4 di una scheda di rete. L'ho pensato per i tecnici di commissioning che lavorano vicino a PLC, sistemi SCADA ed Ethernet industriale, dove una modifica sbagliata o applicata a metà costa cara.

  • Windows 10 / 11
  • Python 3.12+
  • PySide6 (Qt)
  • GPL-3.0
  • Completamente offline
01 L'idea

Prima l'affidabilità, poi la comodità.

Una modifica IP sbagliata o applicata a metà, vicino a un PLC, costa cara. IP CHANGER tratta ogni modifica come una transazione: rilegge la scheda, salva un'istantanea della configurazione, valida i dati, applica la modifica, attende Windows e rilegge la scheda per verificarla. Se la verifica fallisce, propone di ripristinare l'istantanea.

Modifica solo la scheda selezionata. Non tocca mai DNS, IPv6 o regole del firewall, funziona completamente offline e l'eseguibile IP_CHANGER.exe parte senza installare nulla, anche da una chiavetta USB o da una cartella di rete.

L'ho sviluppato tra agosto e settembre 2026: 12 commit, 145 funzioni di test e una CI su GitHub Actions che su Windows esegue lint, type check e test con Python dalla 3.12 alla 3.14, poi compila l'eseguibile.

02 Come si applica una modifica

Sette passaggi, ogni modifica.

  1. 01

    Lettura

    Rilegge la scheda. Se è sparita, non cambia nulla.

  2. 02

    Istantanea

    Salva tutto lo stato precedente, compresi tutti gli indirizzi IPv4, e lo registra su disco.

  3. 03

    Validazione

    Gli errori bloccano la modifica. Gli avvisi informano e lasciano proseguire.

  4. 04

    Applicazione

    Esegue uno script PowerShell fisso. I parametri viaggiano come JSON, mai come testo dello script.

  5. 05

    Attesa

    Lascia a Windows il tempo di aggiornare lo stack di rete.

  6. 06

    Verifica

    Rilegge la scheda e la confronta campo per campo. Un exit code non vale mai come successo.

  7. 07

    Esito

    Successo, oppure un errore spiegato in chiaro con la configurazione precedente pronta da ripristinare. Anche il ripristino viene verificato.

03 Funzioni

Cosa fa.

Rilevamento delle schede

Elenca tutte le schede e le classifica: fisica, wireless, virtuale, VPN, Bluetooth o loopback. Non dà mai per scontato che una scheda si chiami "Ethernet".

Configurazione attuale

Mostra la configurazione IPv4 corrente, tutti gli indirizzi quando una scheda ne ha più di uno, più IPv6 e DNS come riferimento.

Statico e DHCP

Cambia indirizzo, subnet e gateway, oppure passa a DHCP, attende il lease e riporta l'indirizzo ottenuto. Un risultato 169.254.x.x viene segnalato come "nessun server DHCP ha risposto".

Preset legati alla scheda

I preset salvano GUID e MAC della scheda, non solo il nome. Una scheda rinominata viene comunque riconosciuta e un preset non viene mai applicato a un'altra.

Rollback e recupero dopo un crash

Ogni modifica si può annullare. Dopo un crash a metà modifica, all'avvio successivo propone di controllare o ripristinare, e non fa mai rollback da solo.

Dry run, import ed export

Il dry run mostra esattamente cosa cambierebbe. I preset si esportano in JSON e vengono validati all'import; il file è trattato come dati, mai eseguito.

04 Architettura

Com'è fatto.

Interfaccia

  • PySide6 / Qt
  • Pannello schede
  • Preset e cronologia
  • Worker in background

Motore di rete

  • Windows IP Helper API (ctypes)
  • Motore transazionale
  • Validatore e verificatore
  • PowerShell NetTCPIP

Dati e sicurezza

  • Preset e cronologia in SQLite
  • Journal per il recupero
  • Auto-elevazione UAC
  • Test con pytest
LinguaggioPython 3.12+
InterfacciaPySide6 (Qt for Python)
PacchettoPyInstaller, singolo .exe
PiattaformaWindows 10 / 11 (64 bit)
Test145 funzioni di test, piano di test manuale
CIGitHub Actions su Windows
05 Screenshot

L'applicazione in uso.

Schede, preset e cronologia in questi screenshot sono tutti dati di prova.

Finestra principale. Scheda, configurazione attuale e preset salvati.
Validazione immediata. I dati sbagliati vengono bloccati prima di applicare qualsiasi cosa.
DHCP. Una scheda wireless passata all'indirizzamento automatico.
Cronologia. Ogni modifica e il suo esito, compresa una annullata.
Dry run. Il confronto completo prima e dopo, senza scrivere nulla sulla scheda.
Esito verificato. La nuova configurazione riletta da Windows.
06 Codice

Leggi il codice.

IP CHANGER è open source con licenza GPL-3.0. Nel repository ci sono il codice, i test, il piano di test manuale per l'hardware reale e la specifica di implementazione.