ClashBar GitHub
Last updated:
The Sitoi/ClashBar repository on GitHub contains the source code and project README. Visit GitHub Releases to read version notes, or use the table below to find a macOS DMG and its matching SHA-256 checksum.
List of ClashBar GitHub Repositories
- ClashBar GitHub: https://github.com/Sitoi/ClashBar
- ClashBar Topic: https://github.com/topics/clashbar
Latest ClashBar GitHub Releases
| File | Size | Download |
|---|---|---|
| macOS · Apple Silicon · DMG disk image · Core not included | 1.57 MiB | OfficialMirror |
| File checksums (verify downloaded files) | 107 B | OfficialMirror |
| macOS · Apple Silicon · DMG disk image | 21.16 MiB | OfficialMirror |
| File checksums (verify downloaded files) | 99 B | OfficialMirror |
| macOS · x86_64 · DMG disk image · Core not included | 1.64 MiB | OfficialMirror |
| File checksums (verify downloaded files) | 99 B | OfficialMirror |
| macOS · x86_64 · DMG disk image | 22.28 MiB | OfficialMirror |
| File checksums (verify downloaded files) | 91 B | OfficialMirror |
Changelog
What's New
> This update is a system proxy Helper installation fix for v0.3.5: it fixes an issue where, when installed from a downloaded .dmg, the Helper binary and LaunchDaemon plist installed with administrator authorization still carried the com.apple.quarantine attribute and were refused by the system with "Launch Constraint Violation / Refusing to execute quarantined file", resulting in "Helper is authorized but turning on the system proxy toggle has no effect"; it also fixes a flaw where the install script swallowed bootstrap / kickstart failures yet still wrote the "installed" version marker, so the broken state could not be retried automatically. The Helper version number is also bumped to 2, and old broken installations will be forcibly reinstalled to recover.
📝 Changelog
🚀 Improvements
- Failed installs no longer write a success marker: under
set -e, the install script now makeslaunchctl bootstrap(on failure,bootoutfirst and retry once) andkickstarthard failures, and puts the version markerechoas the last step — if any loading step fails, it exits with a non-zero status and passes the rawstderrback to the App without writing the version file, ensuring the next launch can re-trigger installation recovery instead of being permanently locked in an "installed but not working" state. - Installation status check now includes the quarantine attribute: in addition to comparing the version and verifying that the binary is executable and the plist exists,
installedHelperIsCurrent()now also checks thecom.apple.quarantineattribute on both target files; if either file still carries the quarantine attribute, it is treated as "not correctly installed" and the authorized installation flow runs again automatically.
🐞 Bug Fixes
- Helper still carrying the quarantine attribute after installation, causing the system proxy to not take effect: fixes an issue in v0.3.5 where the files installed with administrator authorization to
/Library/PrivilegedHelperTools/com.clashbar.helperand/Library/LaunchDaemons/com.clashbar.helper.pliststill retainedcom.apple.quarantine. The root cause is that files created by a quarantined.app(the download-and-install scenario) have the quarantine attribute re-applied by the kernel, so relying only oncp -Xnot copying the source xattrs is not enough; now, after copying,xattr -c+xattr -d com.apple.quarantineare run explicitly to clear the quarantine attribute, and this is verified beforebootstrap— if it still remains, the script fails and exits immediately, no longer letting a Helper that the system refuses to load silently leave an "installed" marker.
What's Changed
- Add changelog page and update documentation structure by @Sitoi in https://github.com/Sitoi/ClashBar/pull/103
Full Changelog: https://github.com/Sitoi/ClashBar/compare/v0.3.2...v0.3.6