Skip to content

XrayBar 0.2.0

Pre-release
Pre-release

Choose a tag to compare

@heaprip heaprip released this 21 Sep 17:52
· 26 commits to main since this 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.