git404hub

what is groute fr?

suoracle/groute — explained in plain English

Analysis updated 2026-05-18

78KotlinAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

A free Android app for bypassing internet censorship, built on the Xray-core engine with support for multiple tunneling protocols.

vibe map

vibe map loading… check back in a sec.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Import a subscription link to quickly load and auto-refresh a list of VPN servers.

VIBE 2

Test all your servers for speed and connect to the fastest one automatically.

VIBE 3

Keep local in-country websites connecting directly while other traffic goes through the tunnel.

VIBE 4

Find a working Cloudflare clean IP for servers that rely on Cloudflare fronting.

what's the stack?

KotlinJetpack ComposeXray-core

how it stacks up fr

suoracle/groutelightfeather721/destinationcompasshuyujie275-gif/bloodsugarapp
Stars788075
LanguageKotlinKotlinKotlin
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Distributed as a sideloaded APK rather than through the Play Store, so installing from an unknown source must be allowed on first install.

GPL-3.0: you can use and modify the app freely, but if you distribute a modified version, you must also share its source code under the same license.

in plain english

GRoute is a free Android app that helps people get around internet restrictions in their country. It is built on top of Xray-core, an existing engine for tunneling traffic, and wraps it in a clean app interface available in both English and Persian. It supports several different tunneling protocols, VLESS, VMess, Trojan, and Shadowsocks, along with a number of transport methods like TLS, WebSocket, and gRPC that help the connection blend in with normal internet traffic. To use it, you add servers either by pasting individual server links, by pasting a subscription link that imports many servers at once and can auto-refresh on a schedule, or by registering a free Cloudflare WARP configuration in one tap. You can test all your servers for speed and pick the fastest one automatically, then connect with a single tap, after granting Android's VPN and notification permissions. The app includes several features specifically aimed at defeating network censorship: it can split TLS handshakes to avoid detection by deep packet inspection, it can detect the real domain behind a connection to help servers connect correctly, and it includes a built in scanner that finds working Cloudflare IP addresses for servers that rely on Cloudflare fronting. It also has a split routing mode so that local, in-country websites connect directly instead of going through the tunnel, a per-app option to choose exactly which apps use the VPN, an internet quality test that rates your connection for gaming, browsing, streaming, or video calls, and simple charts of your data usage over time. It is written in Kotlin using Jetpack Compose for the interface, and is distributed as a downloadable APK file rather than through the Play Store, so you need to allow installing apps from outside the store the first time. The app has no accounts, analytics, or advertising, and keeps all server settings and usage data only on your device. It is released under the GPL-3.0 license, while the bundled Xray-core engine keeps its own separate MPL-2.0 license.

prompts (copy fr)

prompt 1
I have a subscription link for VPN servers, how do I import it into GRoute and set it to auto-refresh?
prompt 2
Explain what split routing and the Cloudflare clean-IP scanner do in GRoute and when I'd want to use them.
prompt 3
How do I set up per-app proxying in GRoute so only specific apps use the VPN connection?
prompt 4
GRoute is distributed as an APK outside the Play Store, walk me through installing and updating it safely.

Frequently asked questions

what is groute fr?

A free Android app for bypassing internet censorship, built on the Xray-core engine with support for multiple tunneling protocols.

What language is groute written in?

Mainly Kotlin. The stack also includes Kotlin, Jetpack Compose, Xray-core.

What license does groute use?

GPL-3.0: you can use and modify the app freely, but if you distribute a modified version, you must also share its source code under the same license.

How hard is groute to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is groute for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.