clash-party

Project Overview

Clash Party by mihomo-party-org is a Mihomo (Clash Meta) GUI — Electron + React + Vite, 27K stars. Single codebase for Windows / macOS / Linux. Key features: built-in Mihomo binary (auto-download on first run), subscription import (Clash / Mihomo formats), ruleset management (GeoSite / GeoIP / custom rulesets), proxy-group node selection (auto / manual), live traffic panel, system proxy + TUN mode.

Item	Value
Platform	Windows / macOS / Linux (Electron)
Language	Electron + React + Vite
Core	Mihomo (Clash Meta), binary auto-downloaded
License	GPL-3.0

The leading Electron GUI for Mihomo (Clash Meta). Subscriptions, rulesets, proxy groups and traffic panel in one app.

Key Features

• Built-in Mihomo core: auto-download on first launch, stored at ~/.config/mihomo-party/mihomo
• Subscription import: Clash / Mihomo config files, subscription URL, local file
• Rulesets: GeoSite / GeoIP built-in + custom YAML rulesets
• Proxy group selection: auto / manual / strategy, with live node latency test
• TUN mode: calls Mihomo's tun mode to capture all system traffic
• Traffic panel: real-time up/down throughput chart
• System proxy: writes HKCU on Windows, calls networksetup on macOS
• Themes: light / dark, customizable accent color

Target Audience

• Windows / macOS / Linux users running Mihomo (Clash Meta)
• Clash GUI enthusiasts wanting a modern UI
• Cross-platform users switching between Windows and macOS

Quick Start

1. Download the matching installer from Releases
2. First launch auto-downloads the Mihomo core
3. Add a subscription: paste URL or import local file — auto-update supported
4. Pick a strategy-group node → tap System Proxy or TUN mode to enable

Core Advantages

• Three platforms, one codebase: same UI and behavior on Windows / macOS / Linux
• Native Mihomo core: not Clash Core — Mihomo (Clash Meta)
• TUN + system proxy: two takeover modes, switchable anytime

System Requirements

Item	Requirement
OS	Windows / macOS / Linux
Electron	bundled in installer
Mihomo core	auto-downloaded; requires internet

Notes

• TUN mode needs admin: Windows admin rights; macOS / Linux needs sudo
• System proxy writes HKCU: Windows does not touch HKLM — works under normal user rights
• Core follows Mihomo versions: Mihomo updates frequently; Clash Party ships updated built-in binaries