wow-client

English | 中文

The client for the WoW VPN project (https://github.com/zaf-x/WoW). Connects to the server over TLS, authenticates with a 128-bit token, sets up a local TUN device and routes traffic through the tunnel. A live status panel shows transfer rates and client↔server / client↔internet latency.

Requires Linux and root (TUN device + raw ICMP socket for the latency probe).

Usage

# connect directly (trust a custom CA with -c ca.pem)
sudo wow-client start -s vpn.example.com -p 9999 -t <32-hex-chars>

# save servers as named profiles, then pick one interactively
sudo wow-client save myserver -s vpn.example.com -p 9999 -t <32-hex-chars>
sudo wow-client launch

If sudo reports wow-client: command not found, the binary lives outside sudo's PATH (e.g. a pipx or --user install in ~/.local/bin) — run sudo "$(which wow-client)" ... instead.

Options

Profiles

Profiles are stored in $XDG_CONFIG_HOME/wow-client/config.json (~/.config/wow-client/config.json by default), readable only by the owner:

{
  "profiles": {
    "myserver": {
      "host": "vpn.example.com",
      "port": 443,
      "token": "<32-hex-chars>",
      "ca_cert": null,
      "mtu": 1280
    }
  }
}

ca_cert may be a path to a PEM CA certificate, or null to use the system default CA bundle. mtu is the TUN device MTU (default 1280). The file can also be edited by hand.

Install

pip install .

License

wow-client is distributed under the terms of the MIT license.