Back to projects

Open-source Windows tool · v1.0.0

IP CHANGER

A Windows tool for changing a network adapter's IPv4 configuration. I built it for commissioning technicians working next to PLCs, SCADA systems and industrial Ethernet, where a wrong or half-applied change is expensive.

  • Windows 10 / 11
  • Python 3.12+
  • PySide6 (Qt)
  • GPL-3.0
  • Fully offline
01 The idea

Reliability over convenience.

A wrong or half-applied IP change next to a PLC is expensive. IP CHANGER treats every change as a transaction: it reads the adapter, snapshots its configuration, validates the input, applies the change, waits for Windows and reads the adapter back to verify it. If the check fails, it offers to restore the snapshot.

It changes only the adapter you select. It never touches DNS, IPv6 or firewall rules, it works fully offline, and the packaged IP_CHANGER.exe runs without installing anything, from a USB stick or a network share.

I built it between August and September 2026: 12 commits, 145 test functions, and CI on GitHub Actions that lints, type-checks and tests it on Windows with Python 3.12 to 3.14, then builds the executable.

02 How a change is applied

Seven steps, every change.

  1. 01

    Read

    Re-reads the adapter. If it has disappeared, nothing changes.

  2. 02

    Snapshot

    Captures the full previous state, every IPv4 address included, and journals it to disk.

  3. 03

    Validate

    Errors block the change. Warnings inform and let you continue.

  4. 04

    Apply

    Runs a fixed PowerShell script. Parameters travel as JSON, never as script text.

  5. 05

    Wait

    Gives Windows time to update the network stack.

  6. 06

    Verify

    Reads the adapter back and compares it field by field. An exit code is never taken as success.

  7. 07

    Report

    Success, or a plain-language failure with the previous configuration offered back. A restore is verified in turn.

03 Features

What it does.

Adapter discovery

Lists every adapter and identifies it as physical, wireless, virtual, VPN, Bluetooth or loopback. It never assumes an interface is called "Ethernet".

Live configuration

Shows the current IPv4 setup, all addresses when an adapter has more than one, plus IPv6 and DNS for reference.

Static and DHCP

Changes address, subnet and gateway, or switches to DHCP, waits for a lease and reports the address obtained. A 169.254.x.x result is reported as "no DHCP server answered".

Presets tied to the adapter

Presets store the adapter's GUID and MAC, not only its name. A renamed adapter is still matched, and a preset is never applied to a different one.

Rollback and crash recovery

Every change can be undone. After a crash mid-change, the next start offers to check or restore, and never rolls back on its own.

Dry run, import and export

Dry run shows exactly what would change. Presets export to JSON and are validated on import; the file is treated as data, never executed.

04 Under the hood

How it's built.

GUI layer

  • PySide6 / Qt
  • Adapter panel
  • Presets and history
  • Background workers

Network engine

  • Windows IP Helper API (ctypes)
  • Transaction engine
  • Validator and verifier
  • PowerShell NetTCPIP

Storage and safety

  • SQLite presets and history
  • Crash-recovery journal
  • UAC self-elevation
  • pytest suite
LanguagePython 3.12+
UI frameworkPySide6 (Qt for Python)
PackagingPyInstaller, single .exe
PlatformWindows 10 / 11 (64-bit)
Tests145 test functions, manual test plan
CIGitHub Actions on Windows
05 Screenshots

The application in use.

Every adapter, preset and history entry in these screenshots is synthetic.

Main window. Adapter, live configuration and saved presets.
Inline validation. Bad input is caught before anything is applied.
DHCP. A wireless adapter switched to automatic addressing.
History. Every change and its result, including one that was rolled back.
Dry run. The full before and after, with nothing written to the adapter.
Verified result. The new configuration read back from Windows.
06 Code

Read the code.

IP CHANGER is open source under GPL-3.0. The repository has the source, the tests, the manual test plan for real hardware and the implementation spec.