v1.0.0

WirePN 1.0.0

WirePN is an open-source Windows desktop client for WireGuard: import profiles, connect and disconnect, and view diagnostics.

Requirements

• Windows 10 or 11 (64-bit).
• The app requests Administrator (UAC) — WireGuard / Wintun need elevation to create the tunnel.
• Runtime binaries (bundled or placed per runtime/bin/README.txt):
  • wireguard-go.exe
  • wintun.dll (from Wintun)

First run

Use Profiles to import a .conf from your VPN provider or admin, set the active profile, then connect from Connect.

Updates

Settings → Updates checks the latest release on GitHub; there is no automatic install. Download the new installer from the release page when an update is available.

Unsigned builds

Default GitHub Actions builds are not Authenticode-signed. Windows SmartScreen may show a warning on first run — “More info” → “Run anyway” if you trust the source. Signed builds are possible when the maintainer configures a certificate (see project README).

Support

For bugs, use GitHub Issues and paste Settings → Copy support info (remove any secrets from logs if applicable).

Full changes: see CHANGELOG.md in the repository.

v0.3.0

WirePN 0.3.0 — Release notes

Profiles

• Clear import errors: missing fields, empty config, duplicate profile name.
• Import .conf from disk (file picker).
• Export a saved profile to .conf (private key decrypted in the main process).

Connect

• Prominent error banner when tunnel status is error.
• Tunnel stats: RX/TX bytes, last handshake time, session duration via WireGuard UAPI get, refreshed about every 2s while connected.
• UAPI get fix: stop reading when errno= appears (wireguard-go keeps the IPC socket open), so stats are not lost to timeouts.
• Ping to server: ICMP to the Endpoint host (PowerShell Test-Connection), three probes, UI shows average RTT.
• Last handshake time uses the system locale (date/time style), not only the app UI language.

Settings

• Diagnostics: WirePN / Electron / Node / OS versions, user data path, Copy support info for bug reports.
• More reliable diagnostics: health is still fetched if another IPC call fails; “Loading…” while waiting; hint if the main process is an old build without version fields.

Window

• Maximum window size is capped to the designed layout; fullscreen is disabled so the UI is not stretched to full screen.

Build, CI, releases

• GitHub Actions — CI: on push/PR to main — typecheck, lint, test, electron-vite build.
• GitHub Actions — Release: on v* tags — NSIS build and upload of WirePN Setup 0.3.0.exe and .blockmap (unsigned by default: CSC_IDENTITY_AUTO_DISCOVERY=false).
• RELEASING.md — how to bump version, tag, and what gets published.
• ESLint (flat eslint.config.mjs) for local checks and CI.
• Extra unit tests (ping stdout parsing, UAPI helpers, Wintun error mapping).

Upgrading

• No data migration required — run the new installer over the previous install; profiles and settings stay in the app user data folder.

v0.2.0

Changelog

All notable changes to this project are documented in this file.

[0.2.0] — 2026-04-03

Added

• App branding: build/icon.ico, optional build/tray.png for the system tray, favicon in the renderer window.
• Windows: embedded requireAdministrator manifest so the installed app requests UAC elevation on launch (required for WireGuard / Wintun).
• Build pipeline: scripts/after-pack-win.mjs runs rcedit after packaging to apply the manifest and icon without electron-builder’s winCodeSign unpack (avoids symlink privilege issues on some Windows setups).

Notes

• NSIS / installer: build/icon.ico must include at least a 256×256 bitmap (electron-builder requirement for the installer wizard).
• Code signing: Authenticode is not applied in default builds; configure a certificate and signtool if you need signed binaries.
• Release assets: WirePN Setup 0.2.0.exe and the .blockmap file (for future auto-update tooling such as electron-updater).

WirePN Desktop

WirePN — Windows client for WireGuard VPN profiles

WirePN is an unofficial, open-source desktop application for Windows 10 and Windows 11 that helps you manage WireGuard VPN profiles and control the connection from a simple graphical interface. It is built with Electron, TypeScript, and React.

WirePN is not affiliated with, endorsed by, or sponsored by the official WireGuard project or its developers. It is an independent community project.