MLM VPN — Android
Source code · سورس کد
English. This repository holds the full source of the app and of Gereh, the messenger inside it:
| Folder | What it is |
|---|
app/ | The VPN app |
mlm-chat/ | Gereh's core in Rust (identity, Olm/Megolm end-to-end encryption, groups and channels, transports), its Android package, the protocol (mlm-chat/docs/SPEC.md) and the relays' code (mlm-chat/relay/) |
chat/ | Gereh's interface, a fork of Telegram for Android (GPL) |
What the app itself sends to us is all in the code: crash reports (app/src/main/java/com/mlmvpn/scanner/crash/), the Quick Connect pool (app/src/main/java/com/mlmvpn/scanner/quick/MlmPoolClient.kt) and Game Booster statistics (app/src/main/java/com/mlmvpn/scanner/engines/game/booster/crowd/).
Before publishing, the addresses and keys of our own servers and relays were replaced with placeholders (203.0.113.x, *.redacted.invalid, redacted-…) to protect them from attacks. Prebuilt binaries (.so, .aar, .dat) are not in this repository; they are inside each release's APK.
فارسی. این مخزن سورس کامل برنامه و «گره»، پیام‌رسان داخل آن، را دارد:
| پوشه | چیست |
|---|
app/ | برنامهٔ VPN |
mlm-chat/ | هستهٔ گره به زبان Rust (هویت، رمزنگاری سرتاسری Olm/Megolm، گروه و کانال، راه‌های رساندن پیام)، بستهٔ اندروید آن، قرارداد پروتکل (mlm-chat/docs/SPEC.md) و کد رله‌ها (mlm-chat/relay/) |
chat/ | رابط گره، فورک تلگرام اندروید (GPL) |
هرچه خود برنامه برای ما می‌فرستد همه در کد پیداست: گزارش خطا (app/src/main/java/com/mlmvpn/scanner/crash/)، استخر اتصال سریع (app/src/main/java/com/mlmvpn/scanner/quick/MlmPoolClient.kt) و آمار گیم بوستر (app/src/main/java/com/mlmvpn/scanner/engines/game/booster/crowd/).
پیش از انتشار، آدرس و کلید سرورها و رله‌های خودمان با جای‌نگهدار (203.0.113.x، *.redacted.invalid، redacted-…) عوض شده تا از حمله در امان بمانند. فایل‌های ازپیش‌ساخته (.so، .aar، .dat) در این مخزن نیستند و داخل APK هر نسخه هستند.
English
Overview
MLM VPN brings many independent connection engines together behind one
iPhone-style home screen: a V2Ray/Xray client and clean-IP scanner, adaptive
engines that find a working route by themselves, more than twenty connection
methods for restrictive networks, a full Cloudflare control panel, and
Gereh, a messenger that works with no server at all. It is written in
Kotlin and Jetpack Compose (minSdk 24, targetSdk 34, compileSdk 36).
⚠️ This project involves network circumvention and VPN technology. Use it
in compliance with the laws of your jurisdiction. The maintainers do not
encourage or condone illegal use.
Languages
English, فارسی, Русский and 中文 (Russian and Chinese are new in 1.2.43:
menus, buttons and messages are translated; part of the text inside some pages
is still in English). Choose one in Settings › App Language; Gereh follows it.
Gereh — a phone-to-phone messenger (new in 1.2.43)
- No server, no phone number, no email. Your identity is a key made on the
phone, with a name like
ehsan·4821; messages go straight from phone to phone.
- End-to-end encrypted. Every message, photo and file is sealed on the
sender's phone and opened only on the receiver's.
- Many ways to deliver: a shared Wi-Fi even with no internet, Bluetooth when
you are close, the internet through volunteers (users' own phones and
computers), and the Google relay — a small mailbox (Apps Script) in the
user's own Google account for phones that cannot reach each other, such as one
on Irancell and one on MCI. Owners can open their relay to everyone as a
public relay; Google and the owner see only sealed bytes.
- Files in pieces: photos, videos, files and voice messages are cut into
equal parts so they get through any route, including the relay.
- Groups and channels with an owner and admins, settings and member
rights, invite links (with or without approval), and the official channel and
group «MLMVPN Official» with a member count estimated phone to phone.
- Add contacts by QR or card link, or «add nearby» with a 4-symbol check.
Notifications, chat folders and a home-screen widget; Gereh runs in its own
process so its errors never touch the VPN.
Connection engines
- FLUX — an adaptive engine of its own: races many routes, lets you choose
the country and IP version, and proves the real exit after connecting.
- MAE (MLM Adaptive Engine) — you pick your apps and sites; it learns, per
network, which route each one needs and builds foreign exits (a US exit for
Gemini and Google Flow) on your own Cloudflare account.
- V2Ray / Xray client — VLESS, VMess, Trojan, Shadowsocks with REALITY, TLS,
WebSocket, gRPC and XHTTP; subscriptions, batch tests and a two-stage clean-IP
scanner.
- WARP, MASQUE, WireGuard and WARP-in-WARP (Aether core) with an exit
country of your choice over NAT64, and a standalone WARP engine.
- Amnezia — free AmneziaWG, WireGuard and Hysteria2 servers, also carried
through Cloudflare where the line blocks them.
- FENIX — Firefox's free VPN on your own Firefox accounts (33 countries,
50 GB a month per account).
- Proton VPN and Windscribe free servers on your own accounts (every
protocol, through WARP where the provider is blocked), Outline keys,
OpenVPN (TunnelBear and free
.ovpn files) and NPV configs.
- Psiphon, Tor (with a bridge manager that tests bridges from your
line), Geph, Lantern and URnetwork.
- GitHub Tunnel — your own cloud server on your GitHub account's free
allowance; Telegram Proxy on your own Cloudflare; Quick Connect,
Iran configs, the SNI anti-filter (with ECH) and server-less domain fronting.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
