https://github.com/bespredel/awg-command-builder
Native Windows app for Keenetic/Netcraze RCI that simplifies AWG/WireGuard ASC command building and execution in a single executable.
https://github.com/bespredel/awg-command-builder
amneziawg automation command-builder configuration devops networking security wireguard
Last synced: 8 days ago
JSON representation
Native Windows app for Keenetic/Netcraze RCI that simplifies AWG/WireGuard ASC command building and execution in a single executable.
- Host: GitHub
- URL: https://github.com/bespredel/awg-command-builder
- Owner: BespredeL
- Created: 2026-04-23T18:02:23.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-04-27T17:15:40.000Z (about 2 months ago)
- Last Synced: 2026-04-27T19:15:57.949Z (about 2 months ago)
- Topics: amneziawg, automation, command-builder, configuration, devops, networking, security, wireguard
- Language: HTML
- Homepage: https://bespredel.name
- Size: 1.41 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AWG Command Builder
[](./README.md)
[](./README_RU.md)
[](https://go.dev)
[](https://www.microsoft.com/windows)
🚀 Local Windows app for Keenetic/Netcraze RCI API.
AWG Command Builder runs as a native Windows desktop app (WebView2). Internally it uses a local service on `127.0.0.1:18080`, serves embedded UI, authenticates to the router, and executes RCI commands.
---
## ✨ Features
- 🔐 Keenetic RCI authentication with multiple hash strategies (firmware compatibility)
- 🧩 Interface-aware command builder for AWG/WireGuard ASC parameters
- 🖥 Single-file desktop-like app (`AWG-Command-Builder.exe`) with embedded UI and i18n
- 🌐 Multi-language UI (`languages.json`) with external override support
- 🧠 Runs fully inside a native WebView2 app window (no external browser tab)
---
## 📦 Requirements
- Go `1.22+`
- Windows 10/11
---
## 🚀 Run In Development
```powershell
go run .
```
The app opens its own window automatically (no external browser).
---
## 🛠 Build
### Standard build (console)
```powershell
go build -o "AWG-Command-Builder.exe" .
```
### GUI build (recommended, no console window)
```powershell
go build -ldflags="-H=windowsgui" -o "AWG-Command-Builder.exe" .
```
### One-command GUI build
```powershell
.\build-gui.bat
```
---
## 📖 Usage
1. Start `AWG-Command-Builder.exe`
2. The app window opens automatically (WebView2)
3. Enter router IP, login, password
4. Connect, fetch WireGuard interfaces, build and send command
5. Close the application window to stop the app
---
## 🌐 Internationalization
- Embedded language file: `i18n/languages.json`
- On startup, app checks `languages.json` next to `AWG-Command-Builder.exe`
- If external file exists and is valid JSON, it overrides embedded translations
- UI includes:
- language selector
- **Export languages.json from EXE** button
API endpoints:
- `GET /api/i18n` - active language config (embedded or external)
- `GET /api/i18n/export-exe` - download embedded language file
---
## 📁 Project Structure
- `main.go` - backend API + WebView2 desktop window + app lifecycle logic
- `index.html` - frontend UI
- `i18n/languages.json` - default embedded translations
- `build-gui.bat` - GUI build helper