ClashMac

1. 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.

1. 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.

1. 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.

1. 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.

1. 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.

1. 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.

1. 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.

1. System Requirements

• Minimum macOS Version: macOS 13.5 or newer is required to run ClashMac, ensuring compatibility with modern macOS features and security protections.

1. 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.

1. 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.

1. 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.

1. 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.

1. 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.

1. 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:
• 
• 
• 
• 

1. 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.

1. 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.

1. 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.