Breaking Changes
- profiles Custom overwrites are removed; rebuild them as custom profiles
- settings The DNS and NTP override toggles are removed; DNS, NTP, sniffer and TUN are set per key, and picked keys apply to every profile
- tun Desktop TUN settings follow the profile until you pick them; values you changed carry over
- settings Settings the subscription sets belong to the provider; each one can be taken over and handed back
- settings TLS certificates are always checked; the toggle to turn the check off is gone
Features
- core Built on FlClash 0.9.2 with the mihomo v1.19.34 core
- headers Subscription headers: flclashx-view, widgets, settings, special, newdomain, service name and logo, serverinfo, buyplan, buytraffic and background
- headers hideip hides the outbound IP, and app.theme lets the panel set the app theme
- headers flclashx-override works on the profile's own GLOBAL group
- profiles Subscription expiry notices; the renewal button appears on its day without waiting for an update
- profiles External controller and Zashboard from the subscription
- proxies Group and server descriptions; a group's description shows in place of the node it picked
- settings The subscription's authentication sets the proxy account
- profiles App links add a profile without a confirmation and say so
- settings Every setting the config names (ports, mode, TUN, stack, MTU, congestion control, routes, geo and more) is locked to the provider: a closed lock marks the provider's, an open one yours
- settings Take any provider setting over and hand it back one at a time; settings the config leaves out stay yours
- settings Panel header settings apply once per subscription update or profile switch
- settings strict as a third process-finding mode
- ui iOS-style interface: stretchy stacked sheets, context menus and slide-to-pick, drag to go back, docked search and long-press reordering
- ui Sidebar and floating dock; bar buttons lift on hover
- ui Optional two-tier Liquid Glass with frosted dashboard cards, sheets and setting groups, stepping down for good, and out of the subscription's hands, when the GPU falls behind
- theme Redesigned theme colors, a higher-contrast dark mode, a refreshed app icon, new glyphs, empty states and theme page
- l10n French, Spanish and Korean translations, seven languages in all, and a reviewed Russian translation
- dashboard A redesigned dashboard around the current exit, with more cards and IP quality cached for 3 days
- dashboard Enhanced view on new installs; movable status card and announcement
- dashboard Provider logo and name on one row, with the logo cached on disk
- dashboard Tapping the delay opens the server picker; core restart button, now on Android too
- dashboard Service checks through the proxy for Gosuslugi, Sberbank, VK, Yandex and Kinopoisk, and outbound IP risk kept off Cloudflare
- proxies Groups as cards and group tabs as chips
- proxies Search, mode, test all and fold all in one button group, the rest under More; expand or collapse every group at once
- proxies Hide timed-out nodes and search every list
- proxies Add proxies to local proxies; adjustable delay test timeout
- proxies A profile just added opens on its first group
- profiles Custom profiles, with include-all in custom groups
- profiles Profile QR codes and phone-to-TV links
- profiles Share link import, .mrs rule sets and more proxy fields
- editor Word wrap and snippets
- config DNS, NTP, sniffer and TUN set per key; DNS, Hosts and ports apply without a restart; optional general overrides
- config DNS query log; clear the DNS cache by hand or on a network change
- views Sortable tables for connections, requests and DNS; recent requests and live connections on one page; punycode hosts shown in Unicode
- core mihomo v1.19.34: Firefox 148 and Safari 26.3 TLS fingerprints, Snell v6 and several users on a Shadowsocks listener
- core A crashed desktop Core restarts on its own, at most twice in a row, and names the cause
- android A rising vibration as the app opens; holding the start/stop button for five seconds toggles the proxy under a rising vibration
- android Constant 120 Hz; the Core runs in its own process and restarts without restarting the app
- android The VPN notification shows the service or profile name, optionally with a stop button only
- android TUN include and exclude packages always apply and override access control; smart selection of Russian apps and a status bar in access control; TUN routes from the subscription
- android Launcher shortcuts and one-step on-demand access; no Firebase analytics or crash reporting
- android Share today's logs from the settings
- android Says why the VPN did not start when its permission is refused, pointing Android 17 users at the Nearby devices permission
- desktop The first window opens in the phone layout at the top of the screen, so it can always be moved on small screens
- tray Colored tray status icons with a monochrome option on macOS; tray hotkeys, nodes and a delay test
- app File logs and app reset; no China presets; disclaimer and About updated; README rewritten with the subscription headers documented on flclashx.app
- migration Profiles and settings carry over from FlClashX 0.4 on macOS
- proxies A one-line proxy card size, also set by proxies.card:oneline
- settings A switch turns vibration off, and a panel can turn it off with novibrate
- ui An animated GIF or WebP works as the panel background; animated WebP is recommended, being several times smaller than a GIF. It stops on its first frame under reduced motion or when the GPU falls behind
Bug Fixes
- proxies Updating a subscription no longer switches url-test and fallback groups to a dead first node
- proxies A node picked while a subscription update applies is no longer lost
- proxies Load balancers are tested by their nodes, and groups without a URL by the app's test URL, without doubled pings
- profiles A profile chosen while the app is still starting is no longer ignored, and changes typed during a save are kept
- core Long-lived connections keep their route; traffic of a UDP session that moved routes is counted on the new route at once
- core A rule set or geo download past 128 MiB, a malformed .mrs file or a profile with runaway YAML aliases can no longer exhaust memory or freeze the app
- core Updating the GeoIP or ASN database no longer risks crashing the Core
- backup A damaged or oversized backup is rejected instead of restored
- android A VPN start from Quick Settings while the app is starting is no longer lost, and opening the app no longer reloads a running VPN
- android A start cancelled right before the VPN permission prompt no longer blocks later starts
- android A stop on an excluded Wi-Fi network keeps the VPN off after leaving it, and VPN settings changed before exiting apply to the next Quick Settings start
- android Per-app rules on Android 7–9 no longer apply another app's policy to a shared UDP socket
- desktop Making the window narrow no longer closes an open profile editor or loses its changes
- desktop A system proxy FlClashX did not set is left alone; it is released while the Core is down and cleared after a crashed or killed run
- tun A desktop TUN that fails to start is reported and turned off instead of showing as on
- macos TUN runs through a root-owned copy of the Core outside the app and no longer fails after the password prompt
- macos The menu bar popover survives a Dock reopen; logout, restart and shutdown are no longer cancelled; launch at login works on macOS 12; tray groups are capped at 100 nodes
- linux TUN without systemd runs through a per-user copy of the Core and no longer locks other users out; the AppImage starts again
- windows The Helper and client shut down fully before installing, and a stale system proxy is cleared
- ui Many fixes to the interface, keyboard and TV remote focus, and to keeping data through downloads, backups and header updates
- android Any Android APK now installs over any earlier one, whichever ABI variant either is
- android The VPN follows a move from one Wi-Fi network to another when networks are excluded
- linux The Linux RPM and AppImage start on desktops that have no AppIndicator library installed
- windows The Windows installer upgrades a 0.4 install in place instead of installing beside it
- proxy The copied proxy variable on Windows works when pasted into PowerShell
- proxy Stopping the system proxy on macOS no longer turns off an automatic proxy (PAC) configuration
- migration An upgrade from 0.4 keeps a rule list that replaced the subscription's rules
- migration An upgrade from 0.4 keeps running the selected script
- migration An upgrade from 0.4 keeps the settings its override switches protected from the subscription
Performance
- editor Smoother editing of large files; a bracket next to the cursor or thousands of same-named share links no longer stall it
- rules Quick Edit no longer freezes the app on very long rule lists
- android Smoother UI while the proxy is busy
Download based on your OS: