Automated patch orchestration ecosystem written in Rust. It streamlines patching Android applications across multiple upstream patch sources, generating standalone signed APKs, individual Magisk/KernelSU modules, and pre-categorized multi-app bundles with an embedded management WebUI.
- 35+ Pre-Configured Apps: YouTube, YouTube Music, Spotify, Reddit, MicroG, TikTok, Instagram, Twitter/X, Pinterest, Gboard, Google Photos, and more.
- Fast Rust CLI (
revancex): High-performance local building, version resolution, and APK patching with no runtime dependencies beyond Java JDK 17 (Rust 1.85+ MSRV). - Multi-Source APK Acquisition: Resilient fallback pipeline (APKMirror, Uptodown, APKPure API, Aptoide, APKCombo, APKFab, Archive.org, GitHub, GitLab, Codeberg, apkeep) protected by domain-aware circuit breakers.
- Root & Non-Root Packaging: Generate standalone signed APKs, individual Magisk/KernelSU modules, or multi-app bundle zips.
- Embedded WebUI: KernelSU, APatch, and Magisk modules include an interactive, responsive Material 3 Expressive WebUI for inspecting and toggling mounted apps.
- Testing & Health Diagnostics: Built-in environment diagnostic suite (
doctor), static DEX and AndroidManifest validation, and automated smoke testing (test) with failure threshold policies. - Dynamic Configuration & CI/CD: Decoupled YAML definitions (
apps.yaml,sources.yaml,modules.yaml,build.yaml), structured build reporting (BUILD_REPORT.json), automated GitHub Actions pipelines, and an interactive GitHub Pages catalogue.
Browse apps visually on our Web Catalogue or download latest builds below. App configurations are defined in config/apps.yaml.
| App | Patched APK | Single Root Module | Last Updated |
|---|---|---|---|
| AdGuard | AdGuard-4.14.68.apk | — | 2026-10-29 02:23:27 UTC |
| CamScanner | CamScanner-7.24.5.2608200000.apk | — | 2026-10-29 02:23:27 UTC |
| CapCut | CapCut-19.9.0.apk | — | 2026-10-27 02:05:34 UTC |
| Cloudflare WARP | Cloudflare-WARP-6.38.9.apk | — | 2026-10-23 02:26:08 UTC |
| DramaBox | drama_box-patched.apk | — | 2026-09-28 08:40:43 UTC |
| Duolingo | duolingo-patched.apk | — | 2026-10-19 09:51:05 UTC |
| Facebook-585.0.0.47.54.apk | — | 2026-11-06 03:29:53 UTC | |
| Flightradar24 | Flightradar24-11.12.0.apk | — | 2026-10-23 02:26:08 UTC |
| Gboard | Gboard-18.5.4.993608717-release-arm64-v8a.apk | — | 2026-10-27 02:05:34 UTC |
| Google Maps | google_maps-patched.apk | — | 2026-10-12 02:29:17 UTC |
| Google News | google_news-patched.apk | — | 2026-09-28 19:13:02 UTC |
| Google Phone | google_phone-patched.apk | — | 2026-10-12 02:29:17 UTC |
| Google Photos | google_photos-patched.apk | — | 2026-10-19 09:51:05 UTC |
| Hungry Shark World | hungry_shark_world-patched.apk | — | 2026-10-19 09:51:05 UTC |
| Instagram-452.1.0.53.64.apk | — | 2026-10-27 02:05:34 UTC | |
| Lightroom | Lightroom-11.5.31.apk | — | 2026-10-23 02:26:08 UTC |
| MicroG | microg.apk | — | 2026-11-07 02:46:02 UTC |
| MX Player | MX-Player-3.4.1.apk | — | 2026-10-26 01:12:11 UTC |
| Myfitnesspal | myfitnesspal-patched.apk | — | 2026-10-19 09:51:05 UTC |
| Nova Launcher | nova_launcher-patched.apk | — | 2026-10-22 02:06:32 UTC |
| Pinterest-14.23.0.apk | — | 2026-11-06 03:29:53 UTC | |
| Pixiv | pixiv-patched.apk | — | 2026-10-19 09:51:05 UTC |
| Prime Video | prime_video-patched.apk | — | 2026-10-22 02:06:32 UTC |
| Proton VPN | Proton-VPN-5.21.9.0.apk | — | 2026-11-07 02:46:02 UTC |
| Plants vs Zombies | Plants-vs-Zombies-3.18.0.apk | — | 2026-11-06 03:29:53 UTC |
| Reddit-2026.42.0.apk | — | 2026-10-26 01:12:11 UTC | |
| Termius | Termius-7.11.2.apk | — | 2026-10-29 02:23:27 UTC |
| Solid Explorer | solid_explorer-patched.apk | — | 2026-09-27 09:56:46 UTC |
| Soundcloud | soundcloud-patched.apk | — | 2026-10-05 01:57:41 UTC |
| Spotify | spotify-patched.apk | — | 2026-10-05 01:57:41 UTC |
| Stellarium | Stellarium-1.16.3.apk | — | 2026-10-23 02:26:08 UTC |
| Sticker Maker | Sticker-Maker-1.0.12-7.apk | — | 2026-10-29 02:23:27 UTC |
| Strava | strava-patched.apk | — | < 10BC8 td align="left">2026-10-22 02:06:32 UTC|
| Subway Surfers | subway_surfers-patched.apk | — | 2026-10-22 02:06:32 UTC |
| Telegram | telegram-patched.apk | — | 2026-10-19 09:51:05 UTC |
| Threads | Threads-454.0.0.54.79.apk | — | 2026-11-06 03:29:53 UTC |
| TikTok | TikTok-47.7.2.apk | — | 2026-11-06 03:29:53 UTC |
| WPS Office | wps_office-patched.apk | — | 2026-10-19 09:51:05 UTC |
| X Piko | X-Piko-12.40.1-prod.01.apk | — | 2026-11-06 03:29:53 UTC |
| YouTube | YouTube-Music-9.15.51.apk | YouTube-20.05.46-module.zip | 2026-11-07 02:46:02 UTC |
| YouTube Music | youtube_music-patched.apk | revancex-module-youtube_music.zip | 2026-10-19 09:51:05 UTC |
| Bundle Name | Included Apps & Payload Files | Download Link | Release Tag | Updated At |
|---|---|---|---|---|
All Bundlerevancex-bundle-all.zip |
20 Apps / APKs (Click to view)
|
Download Zip | auto-v1.0.5-2026.11.07-b154 |
2026-11-07 02:46:02 UTC |
Core Essentials Bundlerevancex-bundle-core.zip |
4 Apps / APKs (Click to view)
|
Download Zip | auto-v1.0.5-2026.11.07-b154 |
2026-11-07 02:46:02 UTC |
Multimedia Bundlerevancex-bundle-multimedia.zip |
2 Apps / APKs (Click to view)
|
Download Zip | auto-v1.0.5-2026.11.07-b154 |
2026-11-07 02:46:02 UTC |
Productivity Bundlerevancex-bundle-productivity.zip |
3 Apps / APKs (Click to view)
|
Download Zip | auto-v1.0.5-2026.10.29-b145 |
2026-10-29 02:23:27 UTC |
Social Bundlerevancex-bundle-social.zip |
7 Apps / APKs (Click to view)
|
Download Zip | auto-v1.0.5-2026.11.06-b153 |
2026-11-06 03:29:53 UTC |
Tools Bundlerevancex-bundle-tools.zip |
2 Apps / APKs (Click to view)
|
Download Zip | auto-v1.0.5-2026.11.07-b154 |
2026-11-07 02:46:02 UTC |
| Custom Bundle | Download Link | Release Tag | Updated At |
|---|---|---|---|
| None yet | — | — | — |
Download & Installation (Prebuilt CLI)
You do not need to install Rust or compile anything to build your patched APKs or root modules. Simply download the precompiled binary for your system.
Download the latest precompiled CLI binary from GitHub Releases:
- Linux (x86_64): revancex-linux-x86_64.tar.gz
- Windows (x86_64): revancex-windows-x86_64.zip
Prerequisites: Java JDK 17 or higher installed on your system.
# Extract archive and mark as executable
tar -xzf revancex-linux-x86_64.tar.gz
chmod +x revancex# Extract archive
Expand-Archive revancex-windows-x86_64.zip -DestinationPath .Step-by-Step Build Workflow
Verify that your system has all required and recommended tools installed:
./revancex doctor(On Windows: .\revancex.exe doctor)
This verifies Java JDK 17+, Android SDK tools (keytool, zipalign, adb), apkeep, python runtime, bypass services, and configuration integrity.
Download the required patcher JARs, integrations, and tools automatically:
./revancex download-toolsCheck if newer versions of apps or patch bundles are available upstream:
./revancex check-updatesBuild your selected applications using the build subcommand:
-
Build specific applications:
./revancex build --apps youtube,microg --arch arm64-v8a
-
Build all configured applications with failure tolerance and report generation:
./revancex build --apps all --arch arm64-v8a --keep-going --report ./output/BUILD_REPORT.json
-
Supported architectures (
--arch):arm64-v8a(Recommended for modern 64-bit Android devices)armeabi-v7a(32-bit legacy devices)x86_64(Emulators and Chromebooks)all(Universal builds)
-
Optimization modes (
--mode):--mode full: Keeps all resources and languages (default).--mode lite: Strips foreign architectures and unused language assets for minimal APK size.
-
Specify custom output folder:
./revancex build --apps youtube --output ./my-output
Validate built APKs before release or installation:
# Run static manifest/DEX verification or adb smoke test
./revancex test --apps all --fail-threshold 10 --continue- When devices are connected via ADB, it tests APK installation, launch, and checks logcat for crash loops or fatal exceptions.
- In offline or CI environments without physical devices, it performs deep static inspection (valid ZIP structure, valid
classes.dex, readableAndroidManifest.xml).
Package patched APKs into flashable root modules:
-
Single Root Module (one zip per app):
./revancex module --single --apps youtube --output ./modules
-
Multi-App Categorized Bundle Modules: Build pre-categorized bundles (or custom app combinations) with embedded Material 3 WebUI:
./revancex module --bundle --apps social --output ./modules # Social Media Bundle ./revancex module --bundle --apps multimedia --output ./modules # Multimedia Bundle ./revancex module --bundle --apps productivity --output ./modules # Productivity Bundle ./revancex module --bundle --apps tools --output ./modules # Tools & Utilities Bundle ./revancex module --bundle --apps core --output ./modules # Core Essentials Bundle ./revancex module --bundle --apps all --include-webui --output ./modules # All Category Bundles
-
Verify Root Module Integrity:
./revancex verify-module ./modules/revancex-bundle-core.zip
Verify configuration syntax, app schemas, and patch integrity:
./revancex validate --strictOr perform live reachability checks on upstream sources:
./revancex validate --onlineModule Bundle Architecture & Specifications
Each bundle is a flashable Magisk, KernelSU, or APatch module zip structured as follows:
revancex-bundle-<category>.zip
├── META-INF/com/google/android/
│ ├── update-binary # Root flash installer script
│ └── updater-script # #MAGISK header
├── module.prop # Module metadata (id, name, version, author)
├── customize.sh # Environment setup and installation routine
├── utils.sh # Dynamic bind-mount helper functions
├── service.sh # Boot service for active APK bind mounts
├── action.sh # Action button script for root managers
├── uninstall.sh # Clean unmount & file cleanup on module removal
├── apps.list # App package & mount mode mapping
├── webui/ # Embedded management WebUI (if --include-webui is used)
└── apks/ # Patched APK payloads mounted on top of stock base APKs
├── <app_1>.apk
└── <app_2>.apk
Sourced dynamically from
config/modules.yaml.
| Bundle | Zip File | Apps | Included Applications |
|---|---|---|---|
| All | revancex-bundle-all.zip |
20 | Adguard, Camscanner, Duolingo, Facebook, Flightradar24, Gboard, Instagram, Lightroom, Moviebox, Pixiv, Proton Vpn, Reddit, Strava, Threads, Tiktok, Wps Office, X Piko, Youtube, Youtube Music, Hungry Shark World |
| Core Essentials | revancex-bundle.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 |
CLI Subcommand Reference
| Command | Description | Example |
|---|---|---|
doctor |
Inspect local environment, required JDK 17+, Android SDK tools, and network services | revancex doctor |
apps |
List all configured apps, status, and package IDs | revancex apps [--json] |
download-tools |
Download patcher JARs, integrations, and tools | revancex download-tools [--apps youtube] |
check-updates |
Poll upstream sources for app and patch updates | revancex check-updates [--json] |
build |
Patch, optimize, sign APKs, and generate build reports | revancex build --apps youtube --arch arm64-v8a [--keep-going] [--report <path>] |
module |
Package APKs into single or bundle Magisk/KernelSU modules | revancex module --bundle --apps core [--include-webui] |
test |
Smoke test APKs (static DEX/manifest or ADB device) with failure tolerance | revancex test --apps all [--fail-threshold 20] [--continue] |
validate |
Check schema, app definitions, and patch compatibility | revancex validate [--strict] [--online] [--apps youtube] |
clean |
Clean build outputs, caches, or stale tool downloads | revancex clean [--all] [--stale-tools] |
fetch-apk |
Download stock APK using the configured 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 available patches and version compatibilities for an app | revancex patches youtube [--mode root|nonroot] [--json] |
keystore |
Inspect or initialize signing keystore | revancex keystore --info |
report |
Inspect build report and enforce failure threshold policies in CI | revancex report check ./output/BUILD_REPORT.json [--fail-threshold 15] |
sources |
Probe and test APK sources for reachability and version resolution | revancex sources probe youtube |
gen-apps-json |
Generate web catalogue dataset docs/apps.json from release registry |
revancex gen-apps-json |
generate-matrix |
Generate CI build matrix JSON for GitHub Actions | revancex generate-matrix --apps all |
Build from Source (Developers)
Compile the CLI directly from source:
# Prerequisites: Rust 1.85+ and JDK 17+
cargo build --release
# Run compiled binary
./target/release/revancex doctor
./target/release/revancex apps
./target/release/revancex download-tools
./target/release/revancex build --apps youtube,microg --arch arm64-v8aGitHub Actions (Automated Cloud Builds)
- Fork or push to this repository.
- The GitHub Actions workflows run automatically:
- Auto Build: Triggered on schedule or via
workflow_dispatch. - Custom Build: Triggered via the GitHub Pages interface or
workflow_dispatch. - CI Validation & Tests: Runs automated Rust tests and script verifications on every push.
- Auto Build: Triggered on schedule or via
- Download the generated APKs and Magisk modules directly from the Releases tab.
Environment Variables
Copy .env.example to .env and configure credentials. Never commit .env.
| Variable | Description | Default / Example |
|---|---|---|
GITHUB_TOKEN |
Token with repo + workflow scopes (prevents GitHub API rate limits) |
ghp_... |
GITLAB_TOKEN |
(Optional) GitLab token for fetching GitLab-hosted releases without rate limits | glpat-... |
KEYSTORE_PASSWORD |
Keystore password for signing generated APKs | revanced / 666 |
KEYSTORE_FILE |
(Optional) Custom keystore path override | keys/custom.jks |
KEYSTORE_B64 |
(Optional) Base64-encoded keystore for CI pipelines | <base64> |
TG_TOKEN |
(Optional) Telegram bot token for build notifications | 123456:ABC... |
TG_CHAT |
(Optional) Telegram chat ID or channel username | -1001234567890 |
TG_TOPIC |
(Optional) Telegram forum topic / thread ID for supergroups | 42 |
FLARESOLVERR_URL |
(Optional) FlareSolverr endpoint URL | http://localhost:8191/v1 |
TRAWL_URL |
(Optional) Trawl headless browser render service endpoint URL | http://localhost:8000 |
REVANCEX_STATIC_TEST |
(Optional) Force static manifest/DEX testing without ADB device | 1 |
REVANCEX_CB_THRESHOLD |
(Optional) Circuit breaker error threshold before tripping | 3 |
REVANCEX_CB_COOLDOWN_SECS |
(Optional) Circuit breaker cooldown period in seconds | 60 |
REVANCEX_CONFIG_DIR |
(Optional) Override path to config directory | ./config |
REVANCEX_TEMP_DIR |
(Optional) Override path to temporary directory | ./tmp |
Adding a New App
-
Add an entry to
config/apps.yamlfollowing the schema documented inCONFIG.md. -
Query available patches and compatible versions:
./revancex patches <app_id>
-
Validate configuration syntax and patch integrity:
./revancex validate --strict --apps <app_id>
-
Build and test locally:
./revancex build --apps <app_id> ./revancex test --apps <app_id>
Upstream Patch Sources
Sourced dynamically from
config/sources.yaml.