From 78e91ff0293dde10571380ca3d8f1dfbdb553e5e Mon Sep 17 00:00:00 2001 From: Max Lv Date: Sat, 11 Jul 2026 17:15:36 +0800 Subject: [PATCH 1/6] Add meow as the default iOS client List meow (https://madeye.github.io/meow-ios/) in the GUI Clients section of Getting Started and document its core Shadowsocks features. Co-Authored-By: Claude Fable 5 --- docs/doc/getting-started.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/doc/getting-started.md b/docs/doc/getting-started.md index bd754fe3..27033175 100644 --- a/docs/doc/getting-started.md +++ b/docs/doc/getting-started.md @@ -87,11 +87,25 @@ First, you need to pick a shadowsocks server and client implementation. Any impl ## GUI Clients +- [meow][meow-ios]: iOS client (default iOS client). - [shadowsocks-android][ss-android]: Android client. - [shadowsocks-windows][ss-win]: Windows client. - [shadowsocksX-NG][ssx-ng]: MacOS client. - [shadowsocks-qt5][ss-qt5]: Cross-platform client for Windows/MacOS/Linux. +### Default iOS client: meow + +[meow][meow-ios] is the default Shadowsocks client for iOS. Core features for Shadowsocks: + +- Shadowsocks outbound protocol support, powered by the meow-rs engine (Trojan and VLESS outbounds are also available). +- System-wide VPN via a NetworkExtension packet tunnel — no per-app configuration required. +- UDP relay (QUIC/HTTP3 reliability depends on the outbound proxy and may fall back to TCP). +- Rule-based routing with domain, IP, GeoIP, and GeoSITE rules, plus CN-IP TCP bypass for split routing. +- DNS over HTTPS. +- Clash-style YAML subscriptions with profile switching, per-app proxy group selection, and latency testing. +- Live traffic throughput monitoring and per-day usage charts. +- Runs fully on-device with no data collection. Requires iOS 17+; distributed via TestFlight. + ### Feature comparison @@ -162,3 +176,4 @@ First, you need to pick a shadowsocks server and client implementation. Any impl [ssx-ng]: https://github.com/shadowsocks/ShadowsocksX-NG [ss-qt5]: https://github.com/shadowsocks/shadowsocks-qt5 [ss-android]: https://github.com/shadowsocks/shadowsocks-android +[meow-ios]: https://madeye.github.io/meow-ios/ From 190e7e49cef4f6f43c617343fd12d36d9c0c1475 Mon Sep 17 00:00:00 2001 From: Max Lv Date: Sat, 11 Jul 2026 17:20:13 +0800 Subject: [PATCH 2/6] Document SIP002/SIP003/SIP022 support in the meow section Verified against the meow-ios and meow-rs sources: SIP002 ss:// link parsing (paste or QR scan), AEAD and AEAD-2022 ciphers, and native in-process SIP003 plugins (simple-obfs, v2ray-plugin). Co-Authored-By: Claude Fable 5 --- docs/doc/getting-started.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/doc/getting-started.md b/docs/doc/getting-started.md index 27033175..331bffb4 100644 --- a/docs/doc/getting-started.md +++ b/docs/doc/getting-started.md @@ -98,6 +98,9 @@ First, you need to pick a shadowsocks server and client implementation. Any impl [meow][meow-ios] is the default Shadowsocks client for iOS. Core features for Shadowsocks: - Shadowsocks outbound protocol support, powered by the meow-rs engine (Trojan and VLESS outbounds are also available). +- AEAD ciphers (aes-128-gcm, aes-192-gcm, aes-256-gcm, chacha20-ietf-poly1305, xchacha20-ietf-poly1305) and [SIP022](sip022) AEAD-2022 ciphers (2022-blake3-aes-128-gcm, 2022-blake3-aes-256-gcm, 2022-blake3-chacha20-poly1305). +- [SIP002](sip002) `ss://` share links via manual paste or QR code scan, including the plain `method:password` userinfo form used by AEAD-2022, and the legacy base64 form. +- [SIP003](sip003) plugins, implemented natively in-process (iOS does not allow plugin subprocesses): simple-obfs (`obfs-local`, http and tls modes) and v2ray-plugin (WebSocket with optional TLS). - System-wide VPN via a NetworkExtension packet tunnel — no per-app configuration required. - UDP relay (QUIC/HTTP3 reliability depends on the outbound proxy and may fall back to TCP). - Rule-based routing with domain, IP, GeoIP, and GeoSITE rules, plus CN-IP TCP bypass for split routing. From b941e905651fc826b85eb3d22ddcec0e58b00447 Mon Sep 17 00:00:00 2001 From: Max Lv Date: Sat, 11 Jul 2026 17:23:54 +0800 Subject: [PATCH 3/6] Address review comments on the meow section Drop the redundant "(default iOS client)" from the list entry, tighten the section intro, and note that the GUI feature-comparison table covers desktop/Android clients only. Co-Authored-By: Claude Fable 5 --- docs/doc/getting-started.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/doc/getting-started.md b/docs/doc/getting-started.md index 331bffb4..ef0a9ef0 100644 --- a/docs/doc/getting-started.md +++ b/docs/doc/getting-started.md @@ -87,7 +87,7 @@ First, you need to pick a shadowsocks server and client implementation. Any impl ## GUI Clients -- [meow][meow-ios]: iOS client (default iOS client). +- [meow][meow-ios]: iOS client. - [shadowsocks-android][ss-android]: Android client. - [shadowsocks-windows][ss-win]: Windows client. - [shadowsocksX-NG][ssx-ng]: MacOS client. @@ -95,7 +95,7 @@ First, you need to pick a shadowsocks server and client implementation. Any impl ### Default iOS client: meow -[meow][meow-ios] is the default Shadowsocks client for iOS. Core features for Shadowsocks: +[meow][meow-ios] is the default Shadowsocks client for iOS. Its core Shadowsocks-related features are: - Shadowsocks outbound protocol support, powered by the meow-rs engine (Trojan and VLESS outbounds are also available). - AEAD ciphers (aes-128-gcm, aes-192-gcm, aes-256-gcm, chacha20-ietf-poly1305, xchacha20-ietf-poly1305) and [SIP022](sip022) AEAD-2022 ciphers (2022-blake3-aes-128-gcm, 2022-blake3-aes-256-gcm, 2022-blake3-chacha20-poly1305). @@ -113,6 +113,7 @@ First, you need to pick a shadowsocks server and client implementation. Any impl ### Feature comparison +The table below compares the desktop and Android clients; meow's iOS feature set is described in the section above. From 3a67b131de27514cee55b1fd9fab3ebe2c567d26 Mon Sep 17 00:00:00 2001 From: Max Lv Date: Sun, 12 Jul 2026 08:21:11 +0800 Subject: [PATCH 4/6] Describe meow as the recommended iOS client, not the default Co-Authored-By: Claude Fable 5 --- docs/doc/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/doc/getting-started.md b/docs/doc/getting-started.md index ef0a9ef0..94e653f4 100644 --- a/docs/doc/getting-started.md +++ b/docs/doc/getting-started.md @@ -93,9 +93,9 @@ First, you need to pick a shadowsocks server and client implementation. Any impl - [shadowsocksX-NG][ssx-ng]: MacOS client. - [shadowsocks-qt5][ss-qt5]: Cross-platform client for Windows/MacOS/Linux. -### Default iOS client: meow +### Recommended iOS client: meow -[meow][meow-ios] is the default Shadowsocks client for iOS. Its core Shadowsocks-related features are: +[meow][meow-ios] is the recommended Shadowsocks client for iOS. Its core Shadowsocks-related features are: - Shadowsocks outbound protocol support, powered by the meow-rs engine (Trojan and VLESS outbounds are also available). - AEAD ciphers (aes-128-gcm, aes-192-gcm, aes-256-gcm, chacha20-ietf-poly1305, xchacha20-ietf-poly1305) and [SIP022](sip022) AEAD-2022 ciphers (2022-blake3-aes-128-gcm, 2022-blake3-aes-256-gcm, 2022-blake3-chacha20-poly1305). From b404ab8fff6022fd50cc24d3844650f0525c8175 Mon Sep 17 00:00:00 2001 From: Max Lv Date: Sun, 12 Jul 2026 08:24:35 +0800 Subject: [PATCH 5/6] Add meow to the GUI feature comparison table Values verified against the meow-ios source: system-wide packet tunnel (System Proxy), CN-IP bypass/GeoIP rules (CHNRoutes), profile switching, and QR code scanning; no PAC or QR code generation. Co-Authored-By: Claude Fable 5 --- docs/doc/getting-started.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/doc/getting-started.md b/docs/doc/getting-started.md index 94e653f4..f258e2b3 100644 --- a/docs/doc/getting-started.md +++ b/docs/doc/getting-started.md @@ -113,7 +113,7 @@ First, you need to pick a shadowsocks server and client implementation. Any impl ### Feature comparison -The table below compares the desktop and Android clients; meow's iOS feature set is described in the section above. +For meow's full iOS feature set, see the section above.
@@ -123,6 +123,7 @@ The table below compares the desktop and Android clients; meow's iOS feature set + @@ -132,6 +133,7 @@ The table below compares the desktop and Android clients; meow's iOS feature set + @@ -139,6 +141,7 @@ The table below compares the desktop and Android clients; meow's iOS feature set + @@ -146,6 +149,7 @@ The table below compares the desktop and Android clients; meow's iOS feature set + @@ -153,6 +157,7 @@ The table below compares the desktop and Android clients; meow's iOS feature set + @@ -160,6 +165,7 @@ The table below compares the desktop and Android clients; meow's iOS feature set + @@ -167,6 +173,7 @@ The table below compares the desktop and Android clients; meow's iOS feature set +
ssx-ng ss-qt5 ss-androidmeow
✓ ✗ ✓✓
CHNRoutes✓ ✗ ✓✓
PAC Configuration✓ ✗ ✗✗
Profile Switching✓ ✓ ✓✓
QR Code Scan✓ ✓ ✓✓
QR Code Generation✓ ✓ ✓✗
From 59f8aa3d641656efc04c214ae088b6bf10dc0eaf Mon Sep 17 00:00:00 2001 From: Max Lv Date: Sun, 12 Jul 2026 09:21:48 +0800 Subject: [PATCH 6/6] Mark QR code generation as supported by meow meow-ios commit e4facb7 added exporting ss:// URIs and subscription URLs as QR codes. Co-Authored-By: Claude Fable 5 --- docs/doc/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/doc/getting-started.md b/docs/doc/getting-started.md index f258e2b3..5903a6d0 100644 --- a/docs/doc/getting-started.md +++ b/docs/doc/getting-started.md @@ -99,7 +99,7 @@ First, you need to pick a shadowsocks server and client implementation. Any impl - Shadowsocks outbound protocol support, powered by the meow-rs engine (Trojan and VLESS outbounds are also available). - AEAD ciphers (aes-128-gcm, aes-192-gcm, aes-256-gcm, chacha20-ietf-poly1305, xchacha20-ietf-poly1305) and [SIP022](sip022) AEAD-2022 ciphers (2022-blake3-aes-128-gcm, 2022-blake3-aes-256-gcm, 2022-blake3-chacha20-poly1305). -- [SIP002](sip002) `ss://` share links via manual paste or QR code scan, including the plain `method:password` userinfo form used by AEAD-2022, and the legacy base64 form. +- [SIP002](sip002) `ss://` share links via manual paste or QR code scan, including the plain `method:password` userinfo form used by AEAD-2022, and the legacy base64 form. Servers and subscription URLs can also be exported as QR codes for sharing. - [SIP003](sip003) plugins, implemented natively in-process (iOS does not allow plugin subprocesses): simple-obfs (`obfs-local`, http and tls modes) and v2ray-plugin (WebSocket with optional TLS). - System-wide VPN via a NetworkExtension packet tunnel — no per-app configuration required. - UDP relay (QUIC/HTTP3 reliability depends on the outbound proxy and may fall back to TCP). @@ -173,7 +173,7 @@ For meow's full iOS feature set, see the section above. ✓ ✓ ✓ -✗ +✓