Skip to content

SeungKang/wgui

Repository files navigation

wgui

wgui is a simple graphical user interface for wgu that helps you manage and control WireGuard VPN tunnels.

wgui-screenshot.png

Features

  • Create, save, and edit multiple wgu configurations
  • Easily manage multiple tunnels from the comfort of a shiny gui ✨

Supported Systems

Windows and macOS are currently supported. The application can also be built from source; see below for details.

Installation

  1. Download and run installer from the latest release:
  • Windows: wgui-X.X.X-windows-x64.exe
  • macOS: wgui-X.X.X-macos-arm64.pkg
  1. (Optional) Verify the installer authenticity using the steps in the next section
  2. After installation completes, wgui will be available on your system and ready to use

Installer Verification

The cosign tool can verify the installer’s origin, confirming it was built by GitHub Actions and hasn’t been tampered with. A “Verified OK” message indicates a successful cryptographic attestation from GitHub Actions.

  1. Install cosign (https://docs.sigstore.dev/cosign/system_config/installation/)
  2. From the GitHub Releases page, download the installer and matching cosign bundle for your operating system.
  3. Verify the installer using the commands below. Note: Replace VERSION with the release version you downloaded.
# Replace with the version you want to verify
VERSION="0.0.6"

# Uncomment the installer for your operating system
INSTALLER="wgui-${VERSION}-windows-x64.exe"
# INSTALLER="wgui-${VERSION}-macos-arm64.pkg"

cosign verify-blob "${INSTALLER}" \
  --bundle "cosign.bundle" \
  --certificate-identity="https://github.com/SeungKang/wgui/.github/workflows/build.yaml@refs/tags/v${VERSION}" \
  --certificate-oidc-issuer="https://token.actions.githubusercontent.com"

When complete, you’ll see the following output confirming the file’s GitHub Actions attestation:

Verified OK

Installation from source

If you are using an OS that is not supported you can install from source by following the instructions below.

First install Go.

Run the following commands:

go install gitlab.com/stephen-fox/wgu@v0.0.8
go install github.com/SeungKang/wgui@latest
wgui

Thank you

Thank you to Stephan Fox for working together with me on this project. 🤗 He is the creator behind wgu that makes wgui possible.

About

wgui is a graphical user interface for wgu that helps you manage and control WireGuard VPN tunnels

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors