### README

ClashMac Logo

ClashMac 27

Native Proxy Experience Built for macOS

🌐 Official Website      πŸ“– User Manual

Latest Release Downloads Official Website

Dashboard
Route
Topology
Menu
## ✨ 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

---