Star growth

Today—

This week—

This month—

Repository activity

Activity history will appear here once this repo has been tracked for a couple of days.

Embed badge

Show this repository's current trending rank in your README.

Markdown for your README

[![Trending on Repoburst](https://www.repoburst.com/api/badge/chen08209/FlClash)](https://www.repoburst.com/repo/chen08209/FlClash)

README

FlClash

A multi-platform proxy client based on ClashMeta. Simple to use, open source and ad-free.

English · 简体中文

Website · Download · Changelog · Build from source

FlClash dashboard on a MacBook and a phone

Features

One app for Android, Windows, macOS and Linux, with x64 and ARM64 builds on the desktop.
mihomo (Clash.Meta) core with rule routing, proxy groups, latency tests, system proxy and TUN mode.
Profiles from a subscription link or a file, with a built-in editor, override scripts, and custom rules, proxies and proxy groups.
Live views of connections, requests, DNS queries and logs.
Material You design with dynamic color, light and dark themes, and layouts that adapt from phones to desktops.
Backup and restore through WebDAV or a local file.
Platform touches: a Quick Settings tile, per-app proxy and Android TV support on Android; a tray menu and global hotkeys on the desktop.
Open source and ad-free, licensed under GPL-3.0.

Download

Get the latest build from GitHub Releases, or open the website, which picks the right file for your device.

Platform	Packages	Notes
Android	APK for `arm64-v8a`, `armeabi-v7a` and `x86_64`	Most phones use `arm64-v8a`. Also on the F-Droid repository below.
Windows 10 and later	Installer (`.exe`) or portable `.zip`, for x64 and ARM64	Pick ARM64 on Snapdragon and other ARM laptops.
macOS 12 and later	DMG for Apple Silicon and Intel	Also on Homebrew.
Linux	`.deb`, `.rpm` and AppImage, for x64 and ARM64	See the tray note below.

Homebrew

brew tap chen08209/tap
brew install --cask flclash

Linux tray icon

The .deb package installs its own dependencies. With the AppImage or the .rpm, install the AyatanaAppIndicator library so the tray icon can show:

sudo apt-get install libayatana-appindicator3-1   # Debian and Ubuntu
sudo dnf install libayatana-appindicator-gtk3     # Fedora

Usage

Import a profile from a link. Opening a link in this form imports the subscription into FlClash. The clashmeta:// and flclash:// schemes work the same way.

clash://install-config?url=<URL-encoded subscription link>

Automate on Android. Tasker, MacroDroid and similar apps can start, stop or toggle the proxy by starting an activity with one of these actions:

com.follow.clash.action.START
com.follow.clash.action.STOP
com.follow.clash.action.TOGGLE

From a computer, the same works over adb:

adb shell am start -a com.follow.clash.action.TOGGLE

Build from source

You need Flutter 3.47 (release builds use 3.47.4), Go 1.26 and Rust installed through rustup. Each platform builds on its own host, except Android, which builds anywhere.

git clone --recursive https://github.com/chen08209/FlClash.git
cd FlClash
flutter pub get
dart setup.dart android   # or windows, macos, linux

Packages land in dist/. The Go core and the Rust libraries are compiled as part of the Flutter build.

Platform	Also needed
Android	Android SDK with the NDK. Add `--arch arm64` to build a single ABI.
Windows	GCC (MinGW-w64) for the core and Inno Setup 6 for the installer.
macOS	Xcode and Node.js. The script installs `appdmg` through npm.
Linux	Debian or Ubuntu. The script installs the build packages with apt and downloads `appimagetool`.

Run dart setup.dart --help for the remaining options, such as --targets to build only some package formats.

Support

Starring the repository is the easiest way to support the project. Questions and announcements go to the Telegram channel; bugs and feature requests go to GitHub Issues.

License

FlClash is released under the GPL-3.0 license.