A graphical interface for the original command-line tool WarpScout. Built with Go and the Wails framework.
The project integrates code from other forks, eliminating the need to manually configure parameters via the command line.
The application runs on Windows 10/11 only. Administrator rights are not required.
- Synced with Android version. The scanner logic is updated to match the latest warpscout-android (v1.5.2). This includes not only the automatic I1 selection, but also the updated API for account registration (
api.devices.cloudflare.com), as well as other changes in result processing and network handling. - Telegram Check. Taken from warpscout-tg. The app sends actual requests to Telegram servers to check DPI bypass, rather than just verifying a TCP connection.
- Protocols: AmneziaWG, WireGuard, MASQUE.
- Scanning: Custom subnets (CIDR), port sweeping, nested tunnels (WARP-in-WARP).
- Filtering: Exclusion of specific nodes (e.g., DME) or countries (e.g., RU).
- Tools: AWG Junk search, MASQUE SNI search, custom I1 generator, local SOCKS5 proxy.
- Export: Save configurations for AmneziaWG, WireGuard, usque, and Mihomo.
- UI: 6 themes, localization (RU/EN), color-coded ping and Telegram status.
- Download
WarpScoutGUI-windows.exefrom the Releases page. - Run the file. On the first launch, the app will automatically register a WARP account (takes about 30 seconds).
- Select the desired protocol in the top panel, optionally enable
Check Telegram, and clickScan. - To save a configuration, right-click on a suitable endpoint and select the desired format.
App data (settings, history, account) is stored in %APPDATA%\WarpScout\.
Besides AmneziaWG, the app supports WireGuard and MASQUE (QUIC/TCP). The scanning protocol is selected from the dropdown in the top panel. For MASQUE, scanning works through the built-in client, but using the generated usque config requires a separate program.
AmneziaWG (.conf) – for the AmneziaWG client:
- Open the AmneziaWG app.
- Click Add Tunnel.
- Select Import tunnel from file and choose your saved
.conffile.
WireGuard (.conf) – for the official WireGuard client:
- Open the WireGuard app.
- Click Import tunnel from file.
- Select your
.conffile and click Open.
usque (.json) – for the usque client:
- Save
config.jsonto the same folder as theusque.exeexecutable. - Start the proxy with:
usque.exe -c config.json socks -b 127.0.0.1 -p 1080.
Mihomo (.yaml) – for clients based on the Mihomo core (e.g., Clash Verge Rev):
- Place the
.yamlfile in the client's configuration folder. - Activate the profile in the UI and enable system proxy or TUN mode.
Requirements: Go 1.26.3+, Node.js 20+, Wails CLI v2.15.0.
git clone https://github.com/3inker/warpscout-gui.git
cd warpscout-gui/gui
# Run in development mode
wails dev
# Build the executable
wails build- vernette/warpscout – original CLI.
- openwarpkit/warpscout-android – tools and mechanics used from the Android version.
- niklzz/warpscout-tg – Telegram check implementation.



