Repository navigation
EN MacOS App
dongle edited this page Oct 31, 2026
·
2 revisions
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.
- 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=trueinInfo.plist: a pure menu bar app with no Dock icon.
- Download
SniShaper-macos-<arch>.zipfrom the GitHub release, unpack it, and dragSniShaper.appinto/Applications. - 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". - The ⬢ icon in the menu bar means it is running.
- Quit the menu bar app; if the service is running, run
snishaper stopfirst (quitting the menu bar does not stop the standalone service process). - Replace the old
SniShaper.appwith the new one and reopen. Upgrades never delete user data.
- Quit the menu bar app and stop the service.
- Delete
SniShaper.app; disable the system proxy manually if it was enabled. - Optional: delete the
config/,rules/,log/directories created by the CLI.
- 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.
- Home
- 完整使用指南
- CLI 命令参考
- 核心模式详解
- 智能分流详解
- 规则自定义指南
- 界面配置指南
- 证书重新安装
- macOS 菜单栏应用
- Linux 软件包
- 代码结构
- Snishaper-Core 核心库
- CI 与 PR 自动化
- 便携式自动更新器
- 常见问题与排障
- Home
- Usage Guide
- CLI Reference
- Core Proxy Modes
- Auto Routing
- Custom Rules Guide
- GUI Configuration
- Certificate Installation
- macOS Menu Bar App
- Linux Packages
- Code Structure
- Snishaper-Core Library
- CI & PR Automation
- Portable Auto-Updater
- FAQ