Automated Android APK patcher and module orchestrator written in Rust. Revancex fetches stock APKs, applies upstream ReVanced/Morphe patches, and packages standalone signed APKs as well as Magisk, KernelSU, and APatch modules with an embedded WebUI.
- 31 Pre-Configured Apps: YouTube, YouTube Music, Reddit, MicroG, TikTok, Instagram, Facebook, Threads, X Piko, Pinterest, Gboard, Google Maps, Proton VPN, AdGuard, Lightroom, CapCut, Termius, and more.
- Fast Rust CLI (
revancex): Single prebuilt binary with minimal runtime requirements (Java JDK 17+ for patching; Rust 1.85+ if building from source). - Resilient APK Sourcing: Multi-source fallback pipeline (GitHub, GitLab, Archive.org, Codeberg, apkeep, APKPure, APKMirror, Uptodown, Aptoide, APKFab, APKCombo) with integrity, signature, and patch-compatibility checks.
- Root & Non-Root Output: Build standalone signed APKs, single-app root modules, or categorized multi-app bundles.
- Embedded WebUI: Root modules include a Material 3 Expressive WebUI for inspecting and toggling mounted apps in KernelSU, APatch, and Magisk.
- Built-in Diagnostics & CI: Environment checks (
doctor), static/ADB smoke tests (test), YAML/patch validation (validate), and automated GitHub Actions builds.
Browse apps visually on the Web Catalogue, get release alerts on Telegram, or download the latest builds below. App definitions live in config/apps.yaml.
| App | Patched APK | Single Root Module | Last Updated |
|---|---|---|---|
| AdGuard | AdGuard-4.14.68.apk | - | 2026-11-13T08:23:36Z |
| CamScanner | CamScanner-7.24.5.2608200000.apk | - | 2026-11-13T08:23:36Z |
| CapCut | CapCut-20.1.0.apk | - | 2026-11-17T04:56:22Z |
| Cloudflare WARP | Cloudflare-WARP-6.38.11.apk | - | 2026-11-13T08:23:36Z |
| DramaBox | drama_box-patched.apk | - | 2026-09-28 08:40:43 UTC |
| Duolingo | Duolingo-6.98.4.apk | - | 2026-11-13T08:23:36Z |
| Facebook-586.0.0.52.53.apk | - | 2026-11-13T08:23:36Z | |
| Flightradar24 | Flightradar24-11.13.0.apk | - | 2026-11-13T08:23:36Z |
| Gboard | Gboard-18.5.4.993608717-release-arm64-v8a.apk | - | 2026-11-13T08:23:36Z |
| Google Maps | Google-Maps-26.44.06.1006895251.apk | - | 2026-11-17T04:56:22Z |
| Hungry Shark Evolution | Hungry-Shark-Evolution-14.5.0.apk | - | 2026-11-16T02:30:34Z |
| Instagram-453.0.0.57.79.apk | - | 2026-11-11T09:29:12Z | |
| Lightroom | Lightroom-11.5.31.apk | - | 2026-11-13T08:23:36Z |
| MicroG | microg.apk | - | 2026-11-15T02:21:44Z |
| Moviebox | Moviebox-4.0.03.1020.03.apk | - | 2026-11-17T04:56:22Z |
| MX Player | MX-Player-3.5.2.apk | - | 2026-11-13T08:23:36Z |
| Pinterest-14.23.0.apk | - | 2026-11-13T08:23:36Z | |
| Pixiv | Pixiv-6.196.0.apk | - | 2026-11-13T08:23:36Z |
| Proton VPN | Proton-VPN-5.21.9.0.apk | - | 2026-11-17T04:56:22Z |
| Plants vs Zombies | Plants-vs-Zombies-3.18.0.apk | - | 2026-11-17T04:56:22Z |
| Reddit-2026.42.0.apk | - | 2026-11-13T08:23:36Z | |
| Termius | Termius-7.11.2.apk | - | 2026-11-13T08:23:36Z |
| Stellarium | Stellarium-1.16.10.apk | - | 2026-11-15T02:21:44Z |
| Sticker Maker | Sticker-Maker-1.0.12-7.apk | - | 2026-11-13T08:23:36Z |
| Strava | Strava-486.11.apk | - | 2026-11-13T08:23:36Z |
| Threads | Threads-455.0.0.55.72.apk | - | 2026-11-15T02:21:44Z |
| TikTok | TikTok-47.7.3.apk | - | 2026-11-13T08:23:36Z |
| WPS Office | WPS-Office-18.24.apk | - | 2026-11-13T08:23:36Z |
| X Piko | X-Piko-12.41.0-prod.01.apk | - | 2026-11-13T08:23:36Z |
| YouTube | YouTube-21.13.164.apk | YouTube-21.13.164-module.zip | 2026-11-15T02:21:44Z |
| YouTube Music | YouTube-Music-9.15.51.apk | YouTube-Music-9.15.51-module.zip | 2026-11-15T02:21:44Z |
| Bundle Name | Included Apps & Payload Files | Download Link | Release Tag | Updated At |
|---|---|---|---|---|
All Bundlerevancex-bundle-all.zip |
30 Apps / APKs (Click to view)
|
Download Zip | auto-v1.1.0-2026.11.17-b182 |
2026-11-17T04:56:22Z |
Core Essentials Bundlerevancex-bundle-core.zip |
4 Apps / APKs (Click to view)
|
Download Zip | auto-v1.1.0-2026.11.15-b180 |
2026-11-15T02:21:44Z |
Multimedia Bundlerevancex-bundle-multimedia.zip |
2 Apps / APKs (Click to view)
|
Download Zip | auto-v1.1.0-2026.11.15-b180 |
2026-11-15T02:21:44Z |
Productivity Bundlerevancex-bundle-productivity.zip |
3 Apps / APKs (Click to view)
|
Download Zip | auto-v1.1.0-2026.11.13-b178 |
2026-11-13T08:23:36Z |
Social Bundlerevancex-bundle-social.zip |
7 Apps / APKs (Click to view)
|
Download Zip | auto-v1.1.0-2026.11.15-b180 |
2026-11-15T02:21:44Z |
Tools Bundlerevancex-bundle-tools.zip |
2 Apps / APKs (Click to view)
|
Download Zip | auto-v1.1.0-2026.11.17-b182 |
2026-11-17T04:56:22Z |
| Custom Bundle | Download Link | Release Tag | Updated At |
|---|---|---|---|
| None yet | - | - | - |
Prerequisites: Java JDK 17+ (JDK 21 recommended).
-
Get the CLI from GitHub Releases (Linux x86_64 / Windows x86_64), or build from source with Rust 1.85+:
cargo build --release
-
Verify environment & fetch patcher tools:
./revancex doctor ./revancex download-tools
-
Build patched APKs:
# Build specific apps (architectures: arm64-v8a, armeabi-v7a, x86_64, all) ./revancex build --apps youtube,microg --arch arm64-v8a # Build all apps and keep going on individual failures ./revancex build --apps all --arch arm64-v8a --keep-going
Build modes (
--mode):full(default),lite(strips unused ABIs/resources),both(APK + root payload),root/module, orinstall(re-sign without patching). -
Package root modules & smoke test (optional):
# Single-app or categorized bundle module (core, social, multimedia, productivity, tools, all) ./revancex module --single --apps youtube --output ./modules ./revancex module --bundle --apps core --output ./modules # Static DEX/Manifest or ADB device smoke test ./revancex test --apps all --fail-threshold 10 --continue
CLI Subcommands
Global flags: -v, --verbose, -c, --config-dir <dir> (default ./config).
| Command | Description | Example |
|---|---|---|
doctor |
Check Java, Android tools, bypass services, keystore, and config | revancex doctor |
apps |
List configured apps, status, and package IDs | revancex apps [--json] |
download-tools |
Download patcher JARs and patch bundles | revancex download-tools [--apps youtube] |
check-updates |
Poll upstream sources for app and patch updates | revancex check-updates [--json] |
build |
Fetch, verify, patch, sign APKs, and write BUILD_REPORT.json / .md |
revancex build --apps youtube --arch arm64-v8a |
module |
Package APKs into single or bundle Magisk/KernelSU/APatch modules | revancex module --bundle --apps core |
test |
Run static DEX/manifest checks or ADB device smoke tests | revancex test --apps all |
validate |
Validate YAML configs, modules.yaml sync, and patch compatibility |
revancex validate [--strict] [--online] |
clean |
Clear build cache (--all also clears tools/) or stale tools |
revancex clean [--all] [--stale-tools] |
fetch-apk |
Download stock APK using the multi-source chain | revancex fetch-apk youtube [--arch arm64-v8a] |
verify-module |
Verify structure and integrity of a root module zip | revancex verify-module ./modules/revancex-bundle-core.zip |
patches |
List included, excluded, and auto-disabled patches for an app | revancex patches youtube [--mode root|nonroot] |
keystore |
Inspect resolved signing keystore details | revancex keystore --info |
report |
Enforce failure thresholds on BUILD_REPORT.json in CI |
revancex report check ./output/BUILD_REPORT.json |
sources |
Probe and benchmark configured APK sources | revancex sources probe youtube |
gen-apps-json |
Generate docs/apps.json from the release registry |
revancex gen-apps-json |
generate-matrix |
Generate CI build matrix JSON for GitHub Actions | revancex generate-matrix |
Root Module Bundles
Each root module zip (revancex-bundle-<category>.zip) is compatible with Magisk, KernelSU, and APatch, and includes dynamic bind-mount scripts (customize.sh, service.sh, action.sh, uninstall.sh), apks/, and an optional embedded webui/.
| Bundle | Zip File | Apps | Included Applications |
|---|---|---|---|
| All | revancex-bundle-all.zip |
30 | AdGuard, CamScanner, CapCut, Cloudflare WARP, DramaBox, Duolingo, Facebook, Flightradar24, Gboard, Google Maps, Hungry Shark Evolution, Instagram, Lightroom, Moviebox, MX Player, Pinterest, Pixiv, Proton VPN, Plants vs Zombies, Reddit, Termius, Stellarium, Sticker Maker, Strava, Threads, TikTok, WPS Office, X Piko, YouTube, YouTube Music |
| Core Essentials | revancex-bundle-core.zip |
4 | YouTube, YouTube Music, Reddit, X Piko |
| Multimedia | revancex-bundle-multimedia.zip |
2 | YouTube, YouTube Music |
| Productivity | revancex-bundle-productivity.zip |
3 | CamScanner, Lightroom, WPS Office |
| Social | revancex-bundle-social.zip |
7 | Reddit, TikTok, Instagram, Facebook, Threads, X Piko, Pixiv |
| Tools | revancex-bundle-tools.zip |
2 | AdGuard, Proton VPN |
Configuration, Environment Variables & Adding Apps
- YAML Config: App, source, module, and build schemas are documented in
CONFIG.md. - Adding a New App:
- Add an entry to
config/apps.yaml. - Check patches and validate:
./revancex patches <app_id>and./revancex validate --strict --apps <app_id>. - Build and test:
./revancex build --apps <app_id>and./revancex test --apps <app_id>.
- Add an entry to
- Environment Variables: Copy
.env.exampleto.env(never commit.env). Common variables:- Tokens & Signing:
GITHUB_TOKEN,GITLAB_TOKEN,KEYSTORE_PASSWORD,KEYSTORE_FILE,KEYSTORE_B64 - Notifications:
TG_TOKEN,TG_CHAT,TG_CHANNEL,TG_TOPIC - Bypass & Runtime:
FLARESOLVERR_URL,FLARESOLVERR_ENABLED,TRAWL_URL,REVANCEX_STATIC_TEST,REVANCEX_APP_TIMEOUT_SECS - Paths & Logging:
REVANCEX_CONFIG_DIR,REVANCEX_TEMP_DIR,REVANCEX_LOG_DIR,VERBOSE/RUST_LOG,NO_COLOR/REVANCEX_ASCII
- Tokens & Signing:
GitHub Actions (Automated Builds)
Fork or push to extended to run the automated pipelines:
check-updates.yml— Polls upstream patch releases every 23 hours and triggers builds on changes.auto-build.yml/build-and-release.yml— Builds APKs and modules, runs smoke tests, and publishes GitHub Releases.custom-build.yml— Handles custom bundle requests from the Web Catalogue orworkflow_dispatch.update-pages.yml— Syncsconfig/releases_registry.json,README.md, anddocs/apps.json.ci.yml&release-cli.yml— Runscargo fmt,cargo clippy, tests, and builds Linux/Windows CLI binaries.
Upstream Patch Sources
Sourced dynamically from
config/sources.yaml.
Revancex is licensed under the GNU General Public License v3.0.