Skip to content

EN MacOS App

dongle edited this page Oct 31, 2026 · 2 revisions

中文 | English | Русский

macOS Menu Bar App (SnishaperBar)

SniShaper ships on macOS as a menu bar app: a Swift menu bar application (SnishaperBar) handles status display and controls, while the actual proxy engine is carried by the headless snishaper CLI binary bundled inside the app.

Architecture

  • The menu bar app implements no proxy logic: start/stop of the service and the proxy / system proxy toggles are all performed by invoking CLI subcommands.
  • Status polling uses the stable JSON contract of snishaper status --json (every 3 seconds); it never parses human-readable text.
  • LSUIElement=true in Info.plist: a pure menu bar app with no Dock icon.

Installation

  1. Download SniShaper-macos-<arch>.zip from the GitHub release, unpack it, and drag SniShaper.app into /Applications.
  2. First launch: the build is ad-hoc signed but not notarized, so Gatekeeper blocks it. Right-click SniShaper.app → "Open" → confirm; or System Settings → Privacy & Security → "Open Anyway".
  3. The ⬢ icon in the menu bar means it is running.

Upgrading

  1. Quit the menu bar app; if the service is running, run snishaper stop first (quitting the menu bar does not stop the standalone service process).
  2. Replace the old SniShaper.app with the new one and reopen. Upgrades never delete user data.

Removal

  1. Quit the menu bar app and stop the service.
  2. Delete SniShaper.app; disable the system proxy manually if it was enabled.
  3. Optional: delete the config/, rules/, log/ directories created by the CLI.

Limitations

  • Ad-hoc signed/unnotarized: Gatekeeper must be allowed again after every upgrade.
  • Enabling TUN / changing the system proxy requires admin authorization (system proxy goes through networksetup, TUN relies on utun).
  • The menu bar app currently offers core controls (service, proxy, system proxy, diagnostics, logs); use the CLI for the full feature set.

See docs/macos-app.md in the repository for full build instructions and packaging scripts.

Clone this wiki locally