v1.0.3

WhiteVPN Desktop 1.0.3

v1.0.2

WhiteVPN Desktop 1.0.2

The interface reads its version from the binary, so a release no longer
ships an app that names the previous one.

v1.0.1

WhiteVPN Desktop 1.0.1

Reads every subscription shape a panel serves — share links, mihomo
YAML and JSON, sing-box JSON, Xray JSON — instead of share links alone.

v1.0.0

WhiteVPN Desktop is now available for Windows, macOS, and Linux.

The app provides a simple desktop interface for connecting to WhiteVPN subscriptions or your own compatible proxy
configurations. It uses the Mihomo networking engine and is designed to provide the familiar WhiteVPN experience on
desktop systems.

What you can do

• Connect using the built-in WhiteVPN subscription.
• Add your own subscription URLs.
• Import one or multiple individual server configurations.
• Paste a valid configuration using Ctrl+V on Windows/Linux or Cmd+V on macOS.
• Filter servers by country and protocol.
• Select a server manually or let WhiteVPN choose automatically.
• Test server reachability, delay, and download speed.
• Sort and compare servers from the Servers page.
• View both the server’s declared country and the detected public IP country.
• Share individual server configurations.
• Keep the connection running from the system tray.
• Use the application in English or Persian, including full RTL layout and the Vazir font.

Manually imported configurations are stored in the Manual category and appear at the top of the server list for quick
access.

Supported configuration types

WhiteVPN Desktop currently supports individual share links for:

• VLESS
• VMess
• Trojan
• Shadowsocks
• Hysteria 2
• WireGuard

Compatible subscription URLs containing these configurations are also supported.

Connection monitoring

WhiteVPN checks the active connection every 20 seconds.

If an automatically selected server stops working, the app can move to another available server. If you selected a server
manually, WhiteVPN keeps your selection and reports the failure instead of silently switching servers.

Windows

Windows supports both proxy mode and whole-system TUN mode.

Use the x64 package for standard Intel or AMD computers. The ARM64 package is only for Windows-on-ARM devices such as
Snapdragon PCs and Surface Pro X.

macOS

Proxy mode and automatic system proxy configuration are supported.

TUN mode is not available in this version. The application is not currently notarized, so macOS may initially block it. If
this happens, open System Settings → Privacy & Security and allow WhiteVPN Desktop to run.

Download the ZIP from the GitHub Release page. Do not download a raw .app directory from a GitHub Actions artifact because
executable permissions may be lost.

Linux

Proxy mode is available, but the application does not automatically modify GNOME, KDE, or other desktop proxy settings.

Configure supported applications to use:

127.0.0.1:2080

Linux packages are provided as .deb, .rpm, .AppImage, and portable .tar.gz files where available.

Choosing the correct download

• *-windows-x64.zip — standard Windows PCs
• *-windows-arm64-windows-on-arm.zip — Windows-on-ARM devices
• *-macos-arm64.zip — Apple Silicon Macs
• *-macos-amd64.zip — Intel Macs
• *-linux-amd64.deb — Debian and Ubuntu
• *-linux-amd64.rpm — Fedora, RHEL, and compatible distributions
• -linux-amd64-webkit41. — newer distributions using WebKitGTK 4.1
• *-linux-amd64-webkit41.AppImage — portable x86-64 Linux package
• -linux-arm64. — ARM64 Linux systems

Important limitations

This is the first public desktop release, and the following limitations should be understood:

• TUN mode is currently Windows-only.
• Linux system proxy configuration must be performed manually.
• A kill switch is not implemented.
• Packages are not yet code-signed or notarized.
• Applications that ignore the operating system proxy may not use the VPN while in proxy mode.
• Server availability and performance depend on the subscription or configurations being used.

Open source

WhiteVPN Desktop is released under the GNU General Public License version 3.

The application builds and embeds the Mihomo/FlClash networking engine. Third-party sources, versions, checksums, and
license information are documented in THIRD_PARTY_NOTICES.md.

Feedback and security reports

As this is the first public version, bug reports and practical feedback are welcome through the GitHub repository.

Please report security vulnerabilities privately using the instructions in SECURITY.md rather than opening a public issue.