### README
ClashMac 27
Native Proxy Experience Built for macOS
π Official Website
π User Manual
## β¨ Features
### πΊοΈ Visual Route Map
- **Live Flight Routes**: Watch your active proxy traffic fly across the globe in real-time, updating every 10 seconds.
- **Interactive Control**: Zoom, pan, and hover over paths for instant telemetry. Supports historical audit logs.
- **Smart Obfuscation**: Mask your precise location by randomizing your departure point across 190+ global cities.
### π Active Connections & Rules
- **Live Traffic Grid**: Check which apps are consuming bandwidth, their speeds, protocols, and routing rules.
- **One-Click Rule Maker**: Instantly add custom proxy or blocking rules for the active browser tab or process.
- **Instant Cut-off**: Disconnect any hogging connection with a simple right-click.
### π Real-time Dashboard
- **Speed Curves**: High-definition, smooth graph tracking upload and download bandwidth over a 60-second window.
- **Leaderboards**: Automatically lists your most active target domains, matched rules, and destinations.
- **Resource Monitoring**: Track system memory footprint of both the UI and the underlying network engine.
---
## π οΈ Built for macOS
- **100% Native**: Built exclusively in SwiftUI for native performance. Resides quietly in the menu bar with minimal CPU and memory footprints.
- **TUN Enhanced**: System-wide proxy integration with complete UDP/TCP capture.
- **No Setup Needed**: Ready out of the box with automated DNS, TUN, and routing database parameters.
- **Video Boost**: Disable QUIC protocols to prevent ISP throttling and eliminate buffering on YouTube and Netflix.
- **No Repeated Passwords**: Authorize network helper tool installation onceβnever get prompted for admin passwords again.
---
## π» Get Started
- **System Requirement**: macOS 15.0+ (Sequoia or later)
### Installation
1. Download the latest `ClashMac.dmg` disk image from the [Releases page](https://github.com/666OS/ClashMac/releases/latest).
2. Double-click the `.dmg` and **drag** `ClashMac.app` into your **Applications** folder.
> [!CAUTION]
> Do not run ClashMac directly from the `.dmg` installer window, as macOS security sandbox will prevent the application from saving settings and installing system network services.
3. On first launch, right-click `ClashMac.app` and select **Open**. ClashMac will register its system helper tool and automatically download the correct kernel engine matching your Mac's CPU architecture (Apple Silicon or Intel).
---
## π‘οΈ Bypassing Gatekeeper
If macOS blocks launching with a warning (e.g., "developer cannot be verified"), use one of these solutions:
- **System Settings**: Go to **System Settings** $\rightarrow$ **Privacy & Security**, scroll down to find the block notice, and click **Open Anyway**.
- **Terminal Command**: Run the following command in Terminal to clear the quarantine flag:
```bash
sudo xattr -rd com.apple.quarantine /Applications/ClashMac.app
```
---
## π Security & Privacy
- **100% Local**: All settings, traffic details, and history stay locally on your Mac. No data collection, tracking, or logs.
- **Secure Helper**: The background system helper is hardened and restricted to run core files solely from `/Applications/ClashMac.app/`.
---
## π License & Credits
ClashMac is proprietary, closed-source software. Binary releases are provided in this repository.
View third-party credits and licenses here:
π [THIRD_PARTY_LICENSES](https://github.com/666OS/ClashMac/blob/main/THIRD_PARTY_LICENSES.txt)
---
## Star History
[](https://star-history.com/#666OS/ClashMac&Date)
Crafted with β€οΈ for macOS
---