explaingit

666os/clashmac

5,654Audience · generalComplexity · 2/5LicenseSetup · easy

TLDR

ClashMac is a macOS menu-bar app for routing internet traffic through proxy servers, featuring an animated globe Route Map showing connections as flight paths, connection topology tracing, traffic statistics, and support for YAML configs or subscription URLs.

Mindmap

mindmap
  root((ClashMac))
    Route Map
      Animated globe
      Flight path connections
      Privacy city masking
      Day month history
    Traffic Control
      System proxy mode
      TUN mode
      YAML config drag drop
      Subscription URL updates
    Monitoring
      Connection topology view
      Traffic stats panel
      Live menu bar speeds
      Seven day charts
    Platform
      macOS 13 5 plus
      Apple Silicon support
      Intel Mac support
      mihomo proxy core
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Route internet traffic through proxy servers on macOS without editing config files manually

USE CASE 2

Visualize active network connections on an animated globe with flight-path animations

USE CASE 3

Monitor per-process and per-proxy traffic usage with seven-day statistics charts

USE CASE 4

Capture all device traffic at the network level using TUN mode regardless of app proxy support

Tech stack

macOSmihomo proxy coreYAMLTUN networkingMenu bar UI

Getting it running

Difficulty · easy Time to first run · 30min

Requires macOS 13.5 or later on Apple Silicon or Intel. Load config by dragging a YAML file or entering a subscription URL. Common settings auto-filled.

Proprietary and closed-source. You can use it but cannot view, modify, or redistribute the source code. Builds on open-source components internally.

In plain English

ClashMac is a macOS application for routing your internet traffic through proxy servers. A proxy server acts as a go-between for your device and the internet, letting you control which connections go through which servers and change how your traffic appears to websites or network observers. ClashMac is a graphical front-end built for macOS that sits in the menu bar and handles all of that management through a native interface. The standout visual feature is a Route Map: an animated globe that shows your network connections as airplane flight paths, arcing from your location to wherever the proxy server is. Every active connection appears as a moving airplane and the map refreshes every ten seconds. You can scroll to zoom, pan the globe, and review flight history by day or month. In dark mode, the routes glow like city lights. A privacy setting replaces your actual location with one of 190 possible cities so the departure point in the map does not reveal where you are. Beyond the map, there is a Connection Topology view that traces each request from its source on your device through the process that made it, which rule matched it, which proxy handled it, and where it exited. A traffic statistics panel tracks data usage broken down by proxy, process, network interface, or hostname, with seven-day bar charts. The menu bar shows live upload and download speeds. Configuration can be loaded by dragging a YAML file onto the app or by entering a subscription URL that the app checks for updates automatically. ClashMac fills in common settings automatically to reduce manual setup, and supports overriding parameters without editing the underlying config files. It runs in two modes: system proxy (standard) and TUN mode, which captures all traffic at the network level regardless of whether individual apps support proxies. ClashMac requires macOS 13.5 or later and is available for both Apple Silicon and Intel Macs. It is proprietary and closed-source, though it builds on open-source components including the mihomo proxy core.

Copy-paste prompts

Prompt 1
I have ClashMac installed on my Mac. Help me write a YAML proxy configuration file that routes streaming traffic through one proxy and everything else through another.
Prompt 2
Using ClashMac with a subscription URL, how do I set up automatic config updates and override specific parameters without editing the underlying YAML?
Prompt 3
Explain the difference between ClashMac's system proxy mode and TUN mode, and when I should use each one.
Prompt 4
I want to use ClashMac to split traffic so work apps go through a corporate proxy and personal apps go direct. Walk me through the rule configuration.
Prompt 5
How do I interpret the Connection Topology view in ClashMac to debug why a specific app's traffic is not going through the proxy I intended?
Open on GitHub → Explain another repo

← 666os on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.