ClashMac
- Overview
- ClashMac is a native proxy experience designed specifically for macOS, delivering deep system integration, clean visuals, and precise control over how your network traffic travels.
- The application presents a live, map-inspired Route Map that visualizes traffic paths as if you’re charting a journey across continents, oceans, and city grids, transforming abstract data flows into intuitive visuals.
- It emphasizes privacy, performance, and ease of use, combining powerful routing capabilities with a lightweight footprint that stays resident in the menu bar for quick access.
- Built from the ground up with macOS in mind, ClashMac harmonizes with native UI patterns, keyboard shortcuts, and security expectations, while providing a robust configuration and monitoring toolkit for power users.
- The product is complemented by a gallery of visuals that show dashboards, routes, topology, and menu layouts, demonstrating how information is organized and accessed in real time.
- This description draws from the official materials, feature lists, and imagery that showcase ClashMac’s core capabilities, architecture, and user experience design.
- Core Experience — Route Map
- Route Map Orientation: From your starting point, ClashMac maps an arc across the globe to proxy nodes, offering a vivid sense of direction and purpose for every network path you route.
- Multi-hop Transit Visualization: The dialer-proxy chain visualization reveals how packets travel through multiple hops, allowing you to see each transition point and understand how data moves from source to egress with clarity.
- Live Flights Metaphor: Every active connection is depicted as an airplane on a live flight board, with flight statuses refreshing approximately every 10 seconds to reflect the latest changes in connections, latency, and routing decisions.
- Flight Log Explorer: Access a flight log that can be viewed in various time spans—Live, Today, This Month, and Last Month—so you can audit routes, durations, and performance across time.
- Global View and Navigation: The route map supports scrolling to zoom, dragging to pan, and a double-click “home” to return to a default or central view, enabling rapid situational awareness.
- Smart Viewport: The viewport auto-adjusts when you switch time dimensions, ensuring that all routes stay in view and that the most relevant territory remains visible without manual fiddling.
- Continental Route Coding: Routes are color-coded by destination continent (e.g., Asia, Europe, Americas) so you can quickly distinguish regional patterns at a glance.
- Night Lights Aesthetic: In dark mode, active routes glow like city lights, increasing legibility and visual appeal in low-light environments.
- Privacy Mode for Global Viewing: The app can simulate 190+ cities as random departure points, preserving user privacy by decoupling the actual origin from the visualization while still showing realistic traffic dynamics.
- Boarding Ritual: A light, ceremonial touch in the UI alludes to boarding activities, underscoring the concept that the world is vast and we are coordinating journeys through proxy infrastructure.
- Connection Topology (Native Visualization): You can see the full traffic topology—where the data originates, how it flows through processes, which rules apply, which proxy is used, and where egress occurs—providing a transparent view of the data path.
- Complete Chain Transparency: Source IP → Process → Rule → Proxy → Egress is depicted in sequence to show how each layer influences routing decisions and outcomes.
- Nested Grouping: The topology supports nested subgroups, enabling complex proxy structures to be presented in an organized, comprehensible manner.
- Dynamic Highlighting: Hovering over a path illuminates upstream and downstream segments, making it easier to identify critical nodes and potential bottlenecks.
- Hover-Activated Stats: When you hover over a path, statistics are revealed, and popular domains are aggregated to give a quick sense of common traffic themes.
- Traffic Statistics Engine: ClashMac includes a native statistics engine that tracks data with precision, allowing you to inspect traffic at multiple dimensions.
- 4D Tracking: Analysis can be broken down by Proxy, Process, Interface, and Host, offering granular insight into how traffic is allocated and transformed.
- Traffic Trends Visualization: A seven-day bar chart summarizes daily usage, enabling you to identify long-term patterns and spikes at a glance.
- Subscription Usage Insight: The status of traffic progress and expiry dates is presented clearly, helping you manage and renew licenses or configuration sources.
- Rule Statistics and Reset: Visual representations show how often each rule matches traffic, with a one-click reset option to clear tallies during testing or audits.
- Native Architecture
- Native Built for macOS: ClashMac is crafted with SwiftUI and macOS-native APIs, ensuring deep system integration, smooth animations, and consistent look-and-feel with other macOS apps.
- Dual Proxy Modes for Comprehensive Coverage: The product supports both System Proxy usage and a TUN-based enhanced mode, delivering comprehensive traffic coverage across applications and services.
- Lightweight Footprint: Despite powerful capabilities, ClashMac is designed to remain lightweight, occupying a small footprint in the menu bar so it does not disrupt other workflows.
- Visual Dashboard
- Standalone Native Dashboard: A dedicated dashboard app provides a concise overview of Proxies, Rules, Connections, and Logs—letting you monitor network behavior without diving into deeper menus.
- Privacy-Centric by Default: A Privacy Mode feature hides or obfuscates sensitive information like IP addresses and node identifiers when sharing screenshots or presenting data publicly, reducing exposure of sensitive details.
- Proxy & Control
- Real-Time Stats in the Menu Bar: The menu bar surface presents live performance indicators such as speed, the number of connections, and memory usage, enabling quick situational checks.
- One-Click Node Switch: You can switch proxy nodes directly from the menu bar or the dashboard, with latency tests available to help you select the best performing path.
- Auto-Disconnect on Node Change: When you switch nodes, existing connections are cleanly disconnected and redirected to the new node so traffic continues through the updated path without manual intervention.
- Global Hotkeys: System-wide shortcuts give you fast control over proxy operations, including bringing up the dashboard and performing common actions without leaving your current app.
- One-Click Rules on Webpages: Create rule-based routing for the current webpage with one click, supporting major browsers and simplifying per-site proxy configurations.
- Configuration
- Zero-Config Convenience: The app auto-fills DNS, TUN, and GEO parameters to get you up and running quickly, minimizing manual setup for typical environments.
- Remote Subscription Management: You can import remote configurations, enable auto-updates, and apply smart naming conventions to subscriptions for better organization.
- Drag & Drop YAML Configs: Simply drop a YAML configuration into ClashMac to auto-switch, apply, and align settings with your ongoing workflows.
- Pre-Check Before Import: A pre-validation step checks configurations prior to import, pinpointing errors precisely so you can fix issues before they impact operation.
- Unified Parameter Overrides: The system allows parameter overrides across subscriptions, avoiding the need to modify individual files manually.
- Video Boost and QUIC Management: The tool includes a setting to disable overseas QUIC strategies, reducing buffering for video streaming and improving YouTube playback in some geographies.
- System & Experience
- Crash Diagnosis and Self-Healing Guidance: When issues occur, ClashMac auto-identifies causes and offers actionable solutions to restore normal operation.
- Customizable UI: You can show or hide menu items and tailor the layout to your preferences, creating a workspace that fits your workflow.
- Bilingual Experience: The interface can auto-switch between English and Chinese, accommodating a broader user base.
- Password-Free Privileged Helper: The app uses a privileged helper to handle authorization, without prompting for a password each time, balancing convenience with security.
- System Requirements
- Minimum macOS Version: macOS 13.5 or newer is required to run ClashMac, ensuring compatibility with modern macOS features and security protections.
- Download and Installation
- How to Obtain the Latest Version: Retrieve the latest release from the official Releases page, where Apple Silicon and Intel binaries are provided:
- Apple Silicon (M1/M2/M3/M4): ClashMac-v*-macos-arm64.zip
- Intel Mac: ClashMac-v*-macos-x86_64.zip
- Compatible Configuration References: See Test Configurations for guidance on supported setups.
- Installation Steps: 1) Unzip the downloaded file. 2) Drag ClashMac.app into the Applications folder. 3) On first launch, right-click and choose Open to bypass initial macOS security checks.
- Quick Verification: If you’re unsure which chip you have, open the menu at the top-left and select About This Mac to see the Chip information.
- Gatekeeper Advisory: Some unsigned builds may be blocked by macOS Gatekeeper; the following methods help you bypass safely:
- Method 1: Allow in System Settings by selecting Open Anyway under Privacy & Security.
- Method 2: Use Terminal to remove quarantine attributes (xattr -cr /Applications/ClashMac.app).
- Method 3: Remove the quarantine attribute specifically (xattr -d com.apple.quarantine /Applications/ClashMac.app).
- First-Launch Security Note: After applying these steps, reopen the app to complete the trust verification.
- Security Design
- Privileged Helper Security Hardening: The privileged helper is hardened against command injection and other common exploit paths.
- Whitelist Path Validation: Only kernel executions originating from /Applications/ClashMac.app/ are permitted, limiting abuse opportunities.
- Permission Tightening: Access is restricted to administrator-level users to minimize risk exposure.
- POC Verification: The security design has been validated against attempts to misuse common shell paths, including /bin/sh and path traversals.
- Security is a Process, Not a Product: A security tenet echoed in the design philosophy to emphasize ongoing vigilance and iterative improvements.
- Security & Privacy
- Local-Only Operation: ClashMac runs entirely on the user’s macOS device and does not collect or upload user data by default.
- User-Controlled Network Access: Network activity only occurs when explicitly configured by the user or when updating via GitHub, giving you full control over external communications.
- Minimal Permissions: The app requests only the permissions required for its intended functionality, reducing the attack surface and respecting user privacy.
- License and Third-Party Components
- Proprietary Software: ClashMac is a closed-source, proprietary application with binary releases available for distribution.
- Third-Party Licenses: The project uses open-source components, and a complete list of licenses is provided in the THIRDPARTYLICENSES.txt file within the repository.
- Acknowledgments
- mihomo (MetaCubeX/mihomo): Contributor and inspiration for routing and proxy concepts.
- Vernesong (vernesong/mihomo): Collaboration that enriched routing and proxy features.
- Zashboard (Zephyruso/zashboard): Visualization and topology references that informed the UI and routing design.
- Gallery and Visual Snippets
- The following visuals illustrate ClashMac’s UI, workflow, and dashboards:
- Dashboard snapshot, showing the central monitoring hub
- Route snapshot, illustrating path representation across the globe
- Topology snapshot, depicting the complete chain of data from source to egress
- Menu snapshot, showcasing quick access controls and real-time stats
- Included imagery (from the input) provides a tangible sense of how the app looks and behaves in practice:




- Additional Visual and Usage References
- The project maintains a public presence with:
- Official Website: clashmac.app
- Latest Release Badge: a GitHub release badge illustrating up-to-date status
- Downloads Badge: GitHub downloads count badge showing total downloads
- Official Website Badge: a badge highlighting the official site
- Telegram Channel Badge: a badge linking to the project’s Telegram channel
- These badges point to current resources and help users stay informed about updates, releases, and community discussions.
- Usage Narrative and Practical Scenarios
- For a typical macOS user seeking a robust proxy experience, ClashMac offers a coherent workflow:
- Install, open, and let Zero Config parameters populate automatically, reducing time to first use.
- Explore the Route Map to understand how traffic will travel and which proxies will be leveraged, giving you a mental model of online paths.
- Switch between nodes with a single click to optimize latency, then observe Real-Time Stats to verify improvements.
- Use One-Click Rules to tailor routing on a per-site basis, ensuring that critical services get priority through preferred proxies.
- Export or share configurations with Privacy Mode enabled to avoid exposing sensitive data when illustrating network setups to colleagues.
- For power users, the multi-dimensional Traffic Statistics (4D) and Rule Statistics provide rich data for optimization, while the Drag & Drop feature and Pre-Check utilities streamline configuration management across multiple subscriptions.
- Summary and Value Proposition
- ClashMac combines native macOS design with advanced routing visualization, making proxy management both approachable and deeply controllable.
- The Route Map and connection topology give users an intuitive, visual grasp of how traffic moves, where bottlenecks may lie, and which proxies are most effective in different contexts.
- A focus on privacy, security-hardening, and local-data operation reflects a commitment to safeguarding user information while maintaining transparency and configurability.
- The blend of real-time monitoring, automatic updates, customizable UI, bilingual support, and pragmatic installation guidance makes ClashMac a compelling choice for macOS users seeking a native, polished proxy experience.
Images included from the Input:
- ClashMac Logo:
- Dashboard:

- Route:

- Topology:

- Menu:

Star History snippet (visual reference, optional):
Note: This description is composed to reflect the features, architecture, usage scenarios, and assets described in the provided input. It uses a structured, sectioned format with numbered headings and bullet lists, and includes the embedded visuals where appropriate.
Enjoying this project?
Discover more amazing open-source projects on TechLogHub. We curate the best developer tools and projects.
Repository:https://github.com/666OS/ClashMac
GitHub - 666OS/ClashMac: ClashMac
ClashMac is a native proxy experience designed specifically for macOS, delivering deep system integration, clean visuals, and precise control over how your netw...
github - 666os/clashmac