v0.3.0

v0.3.0 — Xray Config Validation & Scan Improvements

May 29, 2026

This release adds end-to-end proxy validation through user-supplied VLESS and Trojan configs, a clipboard copy shortcut, output quality improvements, and several bug fixes contributed by the community.

---

✨ New Features

Scan with Config — Two-Phase xray Validation (PR #26 by @abolix, enhanced by @MatinSenPai)

A brand-new menu item that validates Cloudflare IPs end-to-end through your own proxy config — no external binary required.

Phase 1 — Connectivity scan
Quickly filters a large pool of IPs down to the reachable ones. Fully configurable from the setup screen:

Setting	Options
Config URL	vless://… or trojan://… share URL
Count	1,000 / 5,000 / 20,000 / Custom
Workers	50 / 100 / 200 / Custom
Timeout	2 s / 3 s / 5 s / Custom
Source	Random Cloudflare IPs or From File (ips.txt)
Top N	10 / 25 / 50 / All

Phase 2 — xray validation
Launches an embedded xray instance and tests each candidate IP through the provided config. Results stream live in a progress table.

Additional enhancements in this release:

• Trojan protocol support — paste trojan://… share URLs alongside vless://
• URL paste fix — bracketed paste mode enabled; auto-recovers URLs where the ? separator was silently dropped by the terminal
• From File source — validates your own IP list instead of scanning random ranges; clear errors when ips.txt is missing or empty
• Improved error feedback — inline warning messages on the setup screen instead of silent failures

Clipboard Copy (c key)

Press c during a live scan or on the Results screen to copy all healthy IPs to the system clipboard, one per line — ready to paste straight into a proxy config.

---

🐛 Bug Fixes

• Scan filters and UI status handling (PR #29 by @official-LloydLewis) — fixed colo and CIDR filter logic, corrected UI status message routing, and added ipsrc unit tests
• About page rendering (PR #24 by @M-logique) — corrected text alignment and multiline rendering on the About screen
• Installer version comparison (PR #22 by @M-logique) — normalized parsed version strings before comparing against the latest release tag, fixing false "already up to date" results on some shells

---

🔧 Improvements

• TXT output format — .txt output files now contain one plain IP address per line instead of the previous detail-line format, making them directly usable in xray / Sing-Box / Clash configs without editing
• Healthy-only file output — all output formats (CSV, JSON Lines, TXT) now skip failed probes; only IPs that pass every check are written to disk
• Cross-platform build script — build.ps1 produces signed binaries for all seven target platforms from a single PowerShell session on Windows

---

👥 Contributors

• @abolix — initial Scan with Config implementation, xray-core integration, VLESS parser and builder, unit tests
• @official-LloydLewis — scan filter fixes, UI status handling, ipsrc improvements
• @M-logique — About page rendering fix, installer version normalization
• @MatinSenPai — Trojan support, custom IP source settings, paste fix, enhanced error handling, README update

---

📦 Assets

Platform	Architecture	File
Linux	x86_64	senpaiscanner-linux-amd64
Linux	x86 (32-bit)	senpaiscanner-linux-386
Linux	ARM64	senpaiscanner-linux-arm64
macOS	Intel	senpaiscanner-darwin-amd64
macOS	Apple Silicon	senpaiscanner-darwin-arm64
Windows	x86_64	senpaiscanner-windows-amd64.exe
Windows	x86 (32-bit)	senpaiscanner-windows-386.exe