MarbleNG

🪀 MarbleNG is a private, fast, and intelligent Xray-based VPN client for Android, designed to automatically test your proxy configurations, identify the best-performing route, and keep your connection working when network conditions change.

Built as a native Android client using Xray-core + hev-socks5-tunnel + Android VpnService, MarbleNG combines advanced routing, real-world connection testing, adaptive optimization, and privacy-focused features in a single application.

🚀 Main Features

• Xray-powered — supports VLESS, VMess, Trojan, Shadowsocks, Hysteria2, SOCKS, HTTP/HTTPS and modern Xray transports.

• Smart server testing — test nodes using TCP ping, ICMP ping, or a real Xray tunnel with an actual HTTPS request. Real Tunnel testing verifies whether a server actually works instead of relying only on ping.

• Automatic performance ranking — evaluate latency, reliability and route performance and assign each node a score from 0–100.

• Marble Intelligence 🧠 — an adaptive engine that learns from previous network conditions and automatically tunes connection parameters based on real measurements.

• Marble Turbo ⚡ — tests optimization methods such as TLS fragmentation, Mux reuse and IPv4-first routing, then keeps the configuration that produces real performance improvements.

• Continuous Autopilot — continuously monitors the active route, tests alternatives and can automatically switch when a healthier route is detected.

• Connection Race — tests multiple healthy routes and uses the first one that successfully establishes a connection.

• Smart Failover — automatically recovers from failed connections and can reconnect after network changes such as Wi-Fi ↔ cellular.

🇮🇷 Iran Mode

MarbleNG includes a dedicated Iran Mode designed to adapt the connection to common filtering and network conditions in Iran.

It can detect the network environment and apply appropriate countermeasures, including fragmentation profiles, resolver ordering, MTU adjustments and failover strategies.

Iranian domestic traffic can also be routed directly using GeoIP/GeoSite rules to reduce unnecessary tunnel usage and improve access to local services.

🛡️ Privacy & Protection

MarbleNG includes several layers of connection protection:

• Fail-closed Kill Switch — blocks traffic if the Xray core stops instead of allowing traffic to leak outside the VPN.

• Identity Guard — keeps a stable public exit IP during a session and prevents silent switching to another exit IP.

• DNS leak protection — captures traditional DNS traffic and routes it through encrypted DNS inside the tunnel.

• Privacy Audit — checks your public IP, approximate location and DNS servers through the active tunnel.

• Split tunneling — route all applications through the VPN, only selected apps, or bypass selected apps.

• No sensitive logging — the project states that SSIDs, IMSI information, configuration secrets and passwords are not logged.

🌐 Advanced Networking

MarbleNG provides advanced networking controls including:

• Full-device TUN mode • Local SOCKS5 mode • Adaptive DNS and DoH • IPv4/IPv6 selection • GeoIP & GeoSite routing • Ad blocking • TLS ClientHello fragmentation • Mux / XUDP • Two-hop Chain Proxy • Adaptive MTU • UDP/QUIC probing • Workload profiles: AUTO, INTERACTIVE, STREAMING, STABILITY and STEALTH

📦 Configuration Support

Import configurations through subscription URLs, files, pasted links or supported Xray formats.

Supported inputs include Xray JSON, JSON arrays, Base64 subscriptions and plain link lists.

Supported transports include TCP, WebSocket, XHTTP/SplitHTTP, HTTPUpgrade, gRPC, HTTP/2 and mKCP, with support for TLS, REALITY, uTLS fingerprints, ALPN and ECH.

📱 Android

MarbleNG is built specifically for Android and supports ARM64, ARMv7, x86 and x86_64 devices.

The project is open source and builds Xray-core and hev-socks5-tunnel from pinned upstream versions for reproducible Android builds.