Skip to content

Repository files navigation

Veil app icon

Veil

CI Release License

Veil is a Windows desktop client for TrustTunnel VPN. It wraps the TrustTunnel runtime in a polished WPF app with split tunneling, server setup tools, logs, and a tray-first workflow.

The tunneling engine integration was refined alongside the app, so Veil treats connection setup, split tunneling, diagnostics, and cleanup as one cohesive desktop workflow.

Features

  • Connect and disconnect from a private TrustTunnel VPN.
  • Windows tray menu with show, connect/disconnect, and exit actions.
  • Split tunnel by domains, installed applications, manual executable names, and GeoIP countries.
  • Installed app discovery with executable icons.
  • Log-based split-tunnel suggestions.
  • Remote server setup over SSH with certificate and service checks.
  • JSON import/export for client settings.
  • Single-instance protection and graceful VPN process cleanup.

Requirements

  • Windows 10/11 x64.
  • .NET SDK 9.0 for development.
  • Administrator approval when running Veil, because Wintun adapter creation requires elevation.
  • VeilEngine Windows runtime and wintun.dll in client/.

Veil depends on a patched TrustTunnel client runtime. The engine patch is included in engine/patches, and the dependency script below downloads the matching Windows runtime from Veil releases.

Download runtime dependencies:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\download_deps.ps1

The downloaded files are intentionally ignored by git:

client/trusttunnel_client.exe
client/wintun.dll

Development

dotnet build Veil.sln
dotnet run --project Veil.csproj
dotnet run --project Veil.Tests\Veil.Tests.csproj

Release

Build a portable zip, a VeilEngine runtime zip, and a Windows installer:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\build_release.ps1

Artifacts are written to:

dist/Veil-portable-win-x64.zip
dist/VeilEngine-win-x64.zip
dist/Veil-Setup-win-x64.exe

The installer is per-user and installs to:

%LOCALAPPDATA%\Programs\Veil

Runtime settings are stored separately in:

%APPDATA%\Veil

License

Veil is released under the Apache License 2.0. See LICENSE.

About

Windows desktop client for TrustTunnel VPN with split tunneling and server setup tools.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages