# FlClash A multi-platform proxy client based on ClashMeta. Simple to use, open source and ad-free. **English** · [简体中文](README_zh_CN.md) [![Release](https://img.shields.io/github/v/release/chen08209/FlClash?style=flat-square&label=release)](https://github.com/chen08209/FlClash/releases/latest) [![Downloads](https://img.shields.io/github/downloads/chen08209/FlClash/total?style=flat-square&logo=github)](https://github.com/chen08209/FlClash/releases) [![License](https://img.shields.io/github/license/chen08209/FlClash?style=flat-square)](LICENSE) [![Telegram](https://img.shields.io/badge/Telegram-channel-26A5E4?style=flat-square&logo=telegram&logoColor=white)](https://t.me/FlClash) [Website](https://chen08209.github.io/FlClash) · [Download](#download) · [Changelog](CHANGELOG.md) · [Build from source](#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 Apple-style interaction**: dynamic color, light and dark themes, continuous corners, sheets that snap between heights, 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](https://github.com/chen08209/FlClash/releases/latest), or open the [website](https://chen08209.github.io/FlClash#download), 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** ```bash 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: ```bash 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. ```text clash://install-config?url= ``` **Automate on Android.** Tasker, MacroDroid and similar apps can start, stop or toggle the proxy by starting an activity with one of these actions: ```text com.follow.clash.action.START com.follow.clash.action.STOP com.follow.clash.action.TOGGLE ``` From a computer, the same works over adb: ```bash adb shell am start -a com.follow.clash.action.TOGGLE ``` ## Build from source You need [Flutter](https://docs.flutter.dev/get-started/install) 3.47 (release builds use 3.47.6), [Go](https://go.dev/dl/) 1.27 and [Rust](https://rustup.rs/) installed through rustup. Each platform builds on its own host, except Android, which builds anywhere. ```bash 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](https://jrsoftware.org/isinfo.php) 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](https://t.me/FlClash); bugs and feature requests go to [GitHub Issues](https://github.com/chen08209/FlClash/issues).

## License FlClash is released under the [GPL-3.0 license](LICENSE).