Repository navigation
XrayBar 0.2.0
Pre-release
Pre-release
First public version. A menu-bar app that runs Xray-core with its native TUN on macOS: one process, geosite/geoip routing, nothing in between.
What it does
- Connect from a standard macOS menu; Connect at Launch to the last used server
- Servers: VLESS + Reality/TLS. Import a
vless://link or a QR screenshot (⌘⇧⌃4) from the clipboard, or read-only import from v2rayN; share as QR - Routing sets in v2rayN's format; tunnel exclusions (IPv4 CIDRs)
- DNS goes through the tunnel while connected and is restored afterwards, also after a crash or power loss
- Several Xray versions side by side; a new one gets a trial connection with one-click switch back. Xray v26.9.9 is pinned by SHA-256; routing data (runetfreedom or Loyalsoldier) is checksum-verified
- Optional root-owned helper: Touch ID per Connect instead of the password
- Hold Option in the menu: remove items, copy a server link, technical details
Trust
No binaries are attached on purpose: build it yourself with the Command Line Tools (scripts/make-app.sh, ~20 s). ~1,400 lines of Swift in numbered files, ~200 lines of root scripts, a ~110-line helper. scripts/audit.sh and docs/AUDIT.md (usable as an AI review prompt) let you check what it does. See docs/SECURITY.md for the threat model and known limitations.
Requires macOS 15+ (tested on macOS 26). Every design decision is in docs/DECISIONS.md.