๐Ÿ“–
WannaFlix
WannaFlix (ไธญๆ–‡็ฎ€ไฝ“๏ผ‰
WannaFlix (ไธญๆ–‡็ฎ€ไฝ“๏ผ‰
  • Home
  • Which Protocol to Choose?
  • Which App to Choose?
  • ไธญๆ–‡ๆ•™็จ‹
    • ่€ๆ•™็จ‹
      • Windows
        • SSR
        • Netch (SSR + v2ray) - ๆŽจ่
    • ๆ›ดๆ–ฐๆœๅŠกๅ™จๅˆ—่กจ
    • Windows
      • Clash for Windows (ๆŽจ่๏ผ‰
      • v2rayN (v2ray)
    • Mac OS ่‹นๆžœ็”ต่„‘
      • ClashX (SSR + v2ray) - ๆŽจ่
    • iOS ่‹นๆžœๆ‰‹ๆœบ/ๅนณๆฟ
      • Shadowrocket ๅฐ็ซ็…Ž - ๆŽจ่
    • Android ๅฎ‰ๅ“
      • ClashR (SSR + v2ray) - ๆŽจ่
    • Linux
      • Qv2ray
    • Merlin่ทฏ็”ฑๅ™จ
  • Windows
    • ๐Ÿ‘Clash Verge (Recommended)
    • Clash For Windows (Legacy app)
    • Troubleshooting
  • Mac OS
    • ๐Ÿ‘OneClick [M1 Macs ONLY] (Recommended)
    • ClashX Meta
    • Troubleshooting
  • iOS
    • ๐Ÿ‘OneClick (Recommended)
    • Streisand
    • Switching iTunes Accounts
    • Troubleshooting
  • Android
    • ๐Ÿ‘Clash for Android
    • Troubleshooting
  • Linux
    • V2ray
      • Qv2ray
  • Routers
    • Merlin
      • MerlinClash
      • V2ray
    • OpenWRT
      • OpenClash
      • Passwall
      • ShadowsocksR-Plus
    • SmartDNS
      • Generic Routers
      • Block Public DNS
  • Old Installation Guides
    • Eclipse (OpenVPN)
    • Windows
      • V2rayN (Legacy app) [v6.42+]
      • SmartDNS
      • WannaFlix Official App (Recommended)
      • V2rayN v3.18, v2.50
      • Clash For Windows (deprecated)
      • Clash for Windows
      • SSTap
      • SSR for Windows
      • Proxifier 4.05
      • Netch (Deprecated)
      • NekoRay [Deprecated]
      • Netch [Deprecated]
      • SSR [Deprecated]
    • Mac OS
      • Shadowrocket [M1 Macs ONLY]
      • ClashX v1.30.1 and Higher
      • ShadowsocksX-NG (Recommended)
      • Qv2ray (DEPRECATED)
      • ClashX v1.20 (deprecated)
      • ClashX
      • V2rayU 3.2.0 and Higher
      • Eclipse (OpenVPN)
      • SmartDNS
    • Android
      • Shadowsocks
        • V2rayNG (Recommended)
        • AnXray [Deprecated]
        • ClashR for Android [Deprecated]
      • Trojan
        • Clash for Android
        • v2rayNG (Recommended)
        • AnXray [Deprecated]
        • ClashR for Android (Deprecated)
      • Kitsunebi (Deprecated)
      • WannaFlix Official App (Recommended)
      • SSR
      • Eclipse (OpenVPN)
      • SmartDNS
    • iOS
      • Shadowrocket
      • Shadowrocket
      • Eclipse (OpenVPN)
      • SmartDNS
      • Quantumult (alternative app)
      • Quantumult (alternative app)
    • Linux
      • Shadowsocks-Qt5
    • Routers
      • Merlin-Koolshare Routers
      • Padavan Routers
    • Setup Guides
    • Switching to the New Protocol
    • SmartTV / Media Player
      • SmartDNS
        • SmartTVs
          • Samsung TVs
          • LG TVs
          • Sony TVs
        • Media Players
          • Apple TV
          • Amazon Fire TV
          • Roku
        • Gaming Consoles
          • XBOX 360
          • XBOX ONE
          • PS3 (Playstation 3)
          • PS4 (Playstation 4)
  • Troubleshooting
    • Troubleshooting
      • Download and install the vpn app
    • Your Account & Subscription
    • Installation Issues
    • Connection Issues
    • Netflix Issues
  • Optimizing your connection
  • FAQ
    • Netflix
    • China
    • Whatsapp
    • Support
    • Updating the Server List
    • Alternative Apps + Downloads
  • BLOG
    • March 2023 China Updates - Recommend app updates and Protocol changes
    • WannaFlix's Situation in Iran
    • China Situation - April 2022
    • 2022 Updates
    • The Netflix Situation - August 2021
    • WannaFlix Features List
    • New Protocol!
    • What's new in January 2021?
    • What's new in December 2020?
    • About the Nov. 30 issues + New Servers
    • New Shadowsocks servers!
    • May 2020 Update
    • What affects VPN speeds in China? (26 March 2020)
  • VIP Servers
    • Routing
    • FAQ
  • Archives
    • 2022
    • 2021
      • What's New
      • Which Protocol to Choose? (old)
  • WannaFlix Sub-sites and Tools
  • Useful Websites/Tools
Powered by GitBook
On this page
  • STEP 1: Download and install ClashX
  • Install the Application
  • Launch ClashX
  • STEP 2: Import your config
  • Copy the API
  • Paste the API
  • STEP 3: Select a server and connect
  • OPTION 1: Simple API
  • OPTION 2: Split-tunneling API - decide which server each site will go through
  • You are now connected.
  • FYI [IMPORTANT READ]
  • If you want to play games with Clash or have all apps go through Clash, you need to use TUN Mode instead of System Proxy
  • FAQ
  • How can I update the server list?
  • How can I play games with ClashX?
  • Netflix/other website is using another server to connect instead of the one I selected.

Was this helpful?

  1. Mac OS

ClashX Meta

Setup takes about 8 mins

PreviousOneClick [M1 Macs ONLY] (Recommended)NextTroubleshooting

Last updated 3 days ago

Was this helpful?

Updated: May 1, 2025

App recommendations

If you have an M1 Mac, we recommend for ease of use instead.

ClashX.Meta version 1.4.12 and up (April 2025 release).

ClashX.Meta version 1.4.12 and up supports all major protocols, and works with all our servers. It also supports the TUN engine for capturing all app traffic.

ClashX.Meta is a continuation of the previous app, ClashX Pro. ClashX Pro is no longer updated, so we recommend switching to ClashX.Meta or OneClick instead.

STEP 1: Download and install ClashX

Version: v1.4.12

to download the app.

Alternative mirrors:

  • Download on

Install the Application

  1. Double-click the .zip file. It will extract/unzip the application

  2. Double-click ClashX Meta

Allow ClashX.Meta to run on your Mac

If you encounter a warning stating that the app cannot be opened because Apple cannot check it for malicious software, follow these steps:

  1. Go to System Settings > Privacy & Security.

  2. Click "Open Anyway" next to the warning about ClashX.Meta.

  3. Confirm by clicking "Open" in the subsequent dialog.

Source

Launch ClashX

  • Open ClashX Meta

  • Upon first launch, the app may prompt you to install a helper tool to manage system proxy settings. Click "Install" and provide your administrator password when prompted.โ€‹

You will find the ClashX.Meta icon (a big letter M) in the menu bar (top of the screen).

TIP

If ClashX.Meta runs without any error but you donโ€™t see the icon in the menu bar, itโ€™s likely because your menu bar is too full.

Try quitting a few other apps to free up space โ€” the icon should then appear automatically.

App Icon

The app icon is a big M.

You will find the app in the menu bar at the top right of your screen.

TIP: Launching ClashX.Meta

You can easily find ClashX.Meta again through Spotlight Search:

  1. Press โŒ˜ + Space to open Spotlight.

  2. Type ClashX Meta.

  3. Selecting the app from the search results and pressing Enter to launch it.

This is a quick way to reopen it without navigating through your folders.

STEP 2: Import your config

Copy the API

  1. Select "ClashX Meta" in the dropdown for MacOS

  2. Click "Copy API"

Different API types:

  • Simple API: One proxy group, easy to set up, suitable for basic use. Recommended for new users.

  • Split-tunneling API: Supports multiple proxy groups and service-based routing for advanced control.

  • Subconverter API: A technical tool for advanced users to convert and customize subscription configs across different formats (Clash, Surge, etc.). [Only if you know what it is]

Paste the API

  1. Open ClashX Meta by clicking on the icon at the top of your screen

  2. Go to Config > Remote Config > Manage.

  3. Click Add, paste your subscription URL, and name it.

  4. Click OK, then select and Update the config.

Your server list has now been downloaded to the app.

STEP 3: Select a server and connect

OPTION 1: Simple API

Recommended setup for new users

If you see a different setup that the screenshots, check that you got the correct config API from our website

  1. Click on Wannaflix

  2. Click Benchmark and then select a server with a number next to it

  3. Make sure Proxy Mode is set to Rule, and select Set as system proxy

OPTION 2: Split-tunneling API - decide which server each site will go through

Setup for advanced users

If you don't need split-tunneling, we recommend sticking to the Simple API setup above

  1. Click on Wannaflix

  2. Click Benchmark and then select a server with a number next to it

  3. Make sure Proxy Mode is set to Rule, and select Set as system proxy

What are modes?

Rule - Recommended. Choose this option if you are in China. Websites go to different servers based on pre-configured rule sets.

Global - All websites go through one Wannaflix server. Can cause Chinese sites to malfunction. Only choose this option if you are NOT in China.

Direct - Don't enable. (Disables the VPN).

NOTE: If you are using the SIMPLE API, Rule mode does split tunneling for Chinese and foreign sites automatically (Chinese sites connect directly, not through the VPN, and overseas sites go through the VPN).

Configure split tunneling (Optional)

  1. You'll see a list of different groups(like Wannaflix, ๐ŸŽ Apple, or ๐Ÿ“บ Netflix)

  2. Click on the group name (e.g., ๐Ÿ“บ Netflix)

  3. Select the desired server from the list (e.g., ๐Ÿ‡ฏ๐Ÿ‡ต Japan, ๐Ÿ‡ธ๐Ÿ‡ฌ Singapore, etc.)

  4. That service will now go through your selected server.

You are now connected.

How to disconnect

Unselect "Set as system Proxy"

Make sure to turn the "System Proxy" switch OFF before quiting the app or you won't have any internet if you do so (i.e. it doubles as a kill-switch).

To fix it, restart the app and turn the "System Proxy" switch OFF and then quit the app.

END OF SETUP


FYI [IMPORTANT READ]

If you want to play games with Clash or have all apps go through Clash, you need to use TUN Mode instead of System Proxy

  1. Click the ClashX Meta icon in the menu bar.

  2. Select TUN Mode.

  3. Make sure โ€œSet as system proxyโ€ is unchecked, since TUN handles routing directly.

When TUN mode is enabled, there is no need to enable system proxy.

FAQ

How can I update the server list?

Go to Config > Remote Config > Update

How can I play games with ClashX?

You need to use Tun Mode (see above), and connect to a server that supports UDP.

Netflix/other website is using another server to connect instead of the one I selected.

You have probably selected "Rule" mode and the Netflix website is being redirected to another server based on the Netflix rule set. Select the server you want under "Netflix" in the server list.

Login to your dashboard

OneClick
Click here
Github
https://support.apple.com/guide/mac-help/apple-cant-check-app-for-malicious-software-mchleab3a043/mac
client area