README.md

July 9, 2026 · View on GitHub

Sloth Clash

Clash Meta (Mihomo) desktop client — Wails · Go · React
Windows · macOS · Linux

Русский · 简体中文 · Changelog · Telegram · Support

Sloth Clash preview

Overview

Sloth Clash is a GPL-3.0 GUI around Mihomo (Clash Meta). This repository ships the Wails desktop shell (apps/sloth-clash-desktop). The Windows system service / IPC layer lives in a separate project: sloth-clash-service-ipc (release artifacts are consumed by pnpm run prebuild).

Features (high level)

  • Profiles, proxies, rules, and merge / script-style config workflows in the UI
  • Mihomo core integration (stable channel via prebuild)
  • One-click Proxy / TUN traffic modes with a live connection-health status
  • Visual + YAML rule editor, live connections monitor, and a diagnostics/advanced panel
  • Signed, fail-closed in-app updates (Windows) with UAC-elevated installer hand-off
  • Windows service installer bundle + sidecar layout compatible with Wails packaging
  • Deep link scheme slothclash:// (see wails.json)

Screenshots

Home — connect, mode, traffic, live status
Home — connect, Rule/Global mode, Proxy/TUN traffic, live health & speed		 Profiles — subscriptions
Profiles — import & manage subscriptions, usage, auto-update
Proxies — selector and url-test groups
Proxies — selector / url-test groups with latency and search		 Connections — live traffic
Connections — live per-process traffic, matched rule, up/down
Rules — routing table
Rules — full routing table with type / policy filters		 Edit rules — visual and YAML
Edit rules — visual builder + Advanced (YAML), subscription read-only base
Advanced — diagnostics and tools
Advanced — diagnostics, connectivity probes, recovery tools		 Settings — runtime, updates, diagnostics
Settings — theme, language, connection, updates & diagnostics

Downloads

Latest release — direct downloads (always point to the newest version):

PlatformDownload
Windows (x64)SlothClash-windows-amd64-installer.exe
Windows (ARM64)SlothClash-windows-arm64-installer.exe
macOS (Apple Silicon)SlothClash-macOS-arm64.dmg
macOS (Intel)SlothClash-macOS-x64.dmg
Linux (x64, AppImage)SlothClash-linux-amd64.AppImage
Linux (x64, deb)sloth-clash-linux-amd64.deb
Linux (x64, rpm)sloth-clash-linux-amd64.rpm
Linux (x64, Arch)sloth-clash-linux-amd64.pkg.tar.zst
Linux (x64, tar.gz)sloth-clash-linux-amd64.tar.gz
Linux (ARM64, AppImage)SlothClash-linux-arm64.AppImage
Linux (ARM64, deb)sloth-clash-linux-arm64.deb
Linux (ARM64, rpm)sloth-clash-linux-arm64.rpm
Linux (ARM64, Arch)sloth-clash-linux-arm64.pkg.tar.zst
Linux (ARM64, tar.gz)sloth-clash-linux-arm64.tar.gz

Linux packages install a menu entry, the app icon, and the slothclash:// link handler; the AppImage and tar.gz need webkit2gtk-4.1 + gtk3 from your distro.

All releases & changelog: SlothClash releases. Verify integrity against SHA256SUMS (signed — SHA256SUMS.minisig).
Service binaries used at build time: sloth-clash-service-ipc releases.

Build (local)

Prerequisites: Go 1.25+, Node 20+, pnpm, Wails v2 (go run github.com/wailsapp/wails/v2/cmd/wails@latest works without a global install).

pnpm install
pnpm run desktop:resources   # mihomo sidecar, geo DBs, Sloth service exes, Windows icon → build/
pnpm run wails:dev           # or: pnpm run wails:build

desktop:resources writes under apps/sloth-clash-desktop/build/ (ignored by git). On Windows, pnpm run icons:windows is included there and refreshes build/windows/icon.ico from build/appicon.png so installers / shortcuts pick up the right icon.

CI

GitHub Actions: .github/workflows/desktop-artifacts.yml (Windows, Linux, macOS arm64 + Release) and .github/workflows/desktop-artifacts-darwin-amd64.yml (macOS Intel — same tag, adds zip to the same Release).

Security

Sloth Clash ships fail-closed, cryptographically verified updates: the in-app updater verifies a minisign (ed25519) signature over SHA256SUMS against a public key embedded in the binary, then checks the installer's SHA-256 before launching — anything unsigned or tampered is refused (see docs/UPDATES.md). CI runs govulncheck + pnpm audit on every change, the mihomo core is pinned for reproducible builds, and the project is GPL-3.0 / fully auditable. The privileged helper that manages the core/TUN requires a one-time elevation to install, then runs without further prompts.

To report a vulnerability, see SECURITY.md (use GitHub private vulnerability reporting — please don't open public issues for security bugs).

Contributing

See CONTRIBUTING.md.

Support the project

Sloth Clash is free and GPL-3.0. If it's useful to you, a crypto donation helps keep development and releases going. Thank you! 🦥

AssetAddress
USDT (TRC20)TPACN1kJRm2FnFF1cSqYtBnJwAmZ3qGMni
USDT (Polygon / MATIC)0xD9333e859Fb74D885d22E27568589de61E4433b5
BTCbc1qkkcgpqym967k2x73al6f7fpvkx52q4rzkut3we
ETH0xD9333e859Fb74D885d22E27568589de61E4433b5

Double-check the network before sending — wrong-network transfers are unrecoverable.

Acknowledgements

  • Basis (upstream GUI this work descends from): clash-verge-rev — Clash Verge Rev (Tauri); Sloth Clash reimplements the product direction with Wails + Go in this repo.
  • Proxy core (Clash Meta): MetaCubeX/mihomo.
  • Desktop shell: Wails — Go backend + web frontend in one binary.

Also: zzzgydi/clash-verge (original Clash Verge), and the wider Clash ecosystem.

License

GPL-3.0