Skip to content
thunderkexPublic

About

Modern, high-performance Rust patcher & orchestrator for ReVanced, Morphe. Magisk and KernelSU modules with WebUI and dynamic config.

Topics

Resources

Stars

390 stars

Watchers

4 watching

Forks

Repository files navigation

Revancex

Revancex

Telegram License: GPL-3.0

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.

Highlights

  • 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.

Downloads & Supported Apps

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.

Patched Apps & Single Root Modules

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 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 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 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 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 Modules (Multi-App)

Bundle Name Included Apps & Payload Files Download Link Release Tag Updated At
All Bundle
revancex-bundle-all.zip
30 Apps / APKs (Click to view)
  • AdGuard: apks/adguard.apk
  • CamScanner: apks/camscanner.apk
  • CapCut: apks/capcut.apk
  • Cloudflare WARP: apks/cloudflare_warp.apk
  • DramaBox: apks/drama_box.apk
  • Duolingo: apks/duolingo.apk
  • Facebook: apks/facebook.apk
  • Flightradar24: apks/flightradar24.apk
  • Gboard: apks/gboard.apk
  • Google Maps: apks/google_maps.apk
  • Hungry Shark Evolution: apks/hungry_shark_evolution.apk
  • Instagram: apks/instagram.apk
  • Lightroom: apks/lightroom.apk
  • Moviebox: apks/moviebox.apk
  • MX Player: apks/mx_player.apk
  • Pinterest: apks/pinterest.apk
  • Pixiv: apks/pixiv.apk
  • Proton VPN: apks/proton_vpn.apk
  • Plants vs Zombies: apks/pvz_free.apk
  • Reddit: apks/reddit.apk
  • Termius: apks/serverauditor.apk
  • Stellarium: apks/stellarium.apk
  • Sticker Maker: apks/sticker_maker.apk
  • Strava: apks/strava.apk
  • Threads: apks/threads.apk
  • TikTok: apks/tiktok.apk
  • WPS Office: apks/wps_office.apk
  • X Piko: apks/x_piko.apk
  • YouTube: apks/youtube.apk
  • YouTube Music: apks/youtube_music.apk
Download Zip auto-v1.1.0-2026.11.17-b182 2026-11-17T04:56:22Z
Core Essentials Bundle
revancex-bundle-core.zip
4 Apps / APKs (Click to view)
  • YouTube: apks/youtube.apk
  • YouTube Music: apks/youtube_music.apk
  • Reddit: apks/reddit.apk
  • X Piko: apks/x_piko.apk
Download Zip auto-v1.1.0-2026.11.15-b180 2026-11-15T02:21:44Z
Multimedia Bundle
revancex-bundle-multimedia.zip
2 Apps / APKs (Click to view)
  • YouTube: apks/youtube.apk
  • YouTube Music: apks/youtube_music.apk
Download Zip auto-v1.1.0-2026.11.15-b180 2026-11-15T02:21:44Z
Productivity Bundle
revancex-bundle-productivity.zip
3 Apps / APKs (Click to view)
  • CamScanner: apks/camscanner.apk
  • Lightroom: apks/lightroom.apk
  • WPS Office: apks/wps_office.apk
Download Zip auto-v1.1.0-2026.11.13-b178 2026-11-13T08:23:36Z
Social Bundle
revancex-bundle-social.zip
7 Apps / APKs (Click to view)
  • Reddit: apks/reddit.apk
  • TikTok: apks/tiktok.apk
  • Instagram: apks/instagram.apk
  • Facebook: apks/facebook.apk
  • Threads: apks/threads.apk
  • X Piko: apks/x_piko.apk
  • Pixiv: apks/pixiv.apk
Download Zip auto-v1.1.0-2026.11.15-b180 2026-11-15T02:21:44Z
Tools Bundle
revancex-bundle-tools.zip
2 Apps / APKs (Click to view)
  • AdGuard: apks/adguard.apk
  • Proton VPN: apks/proton_vpn.apk
Download Zip auto-v1.1.0-2026.11.17-b182 2026-11-17T04:56:22Z

Custom Bundle Modules

Custom Bundle Download Link Release Tag Updated At
None yet - - -

Quick Start (CLI)

Prerequisites: Java JDK 17+ (JDK 21 recommended).

  1. Get the CLI from GitHub Releases (Linux x86_64 / Windows x86_64), or build from source with Rust 1.85+:

    cargo build --release
  2. Verify environment & fetch patcher tools:

    ./revancex doctor
    ./revancex download-tools
  3. 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, or install (re-sign without patching).

  4. 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

Reference & Configuration

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:
    1. Add an entry to config/apps.yaml.
    2. Check patches and validate: ./revancex patches <app_id> and ./revancex validate --strict --apps <app_id>.
    3. Build and test: ./revancex build --apps <app_id> and ./revancex test --apps <app_id>.
  • Environment Variables: Copy .env.example to .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
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 or workflow_dispatch.
  • update-pages.yml — Syncs config/releases_registry.json, README.md, and docs/apps.json.
  • ci.yml & release-cli.yml — Runs cargo fmt, cargo clippy, tests, and builds Linux/Windows CLI binaries.
Upstream Patch Sources

Sourced dynamically from config/sources.yaml.

ID Repository Asset Pattern
anddea anddea/revanced-patches *.mpp
de_revanced RookieEnough/De-Vanced *.mpp
piko crimera/piko *.mpp
piko_ig_lite crimera/piko-ig-lite *.mpp
piko_newx crimera/piko-newx *.mpp
morphe_patches MorpheApp/morphe-patches *.mpp
icysymmetra icysymmetra/tiktok-patches-for-morphe *.mpp
hoodles hoo-dles/morphe-patches *.mpp
rushiranpise rushiranpise/morphe-patches *.mpp
durgesh durgesh0505/chiggi_morphe_patches *.mpp
arandomhooman arandomhooman/hoomans-morphe-patches *.mpp
hxreborn hxreborn/morphe-patches *.mpp
bholey BholeyKaBhakt/android-patches-xtra *.mpp
jkennethcarino jkennethcarino/adobo *.mpp
sapitosucio SapitoSucio/FroggoMorphePatches *.mpp
browzomje browzomje/browzomje-patches *.mpp
blazeftl BlazeFTL/FTL-Patches *.mpp
byehi98 byehi98/okish-morphe-patches *.mpp
hushfeed SysAdminDoc/HushFeed *.mpp
hushfacebook SysAdminDoc/Hushfacebook *.mpp
hushthreads SysAdminDoc/HushThreads *.mpp
legendsciber legendsciber/morphe-patches *.mpp
bearinmindcat bearinmindcat/morphe-patches *.mpp
jasonwu jasonwu1994/Gboard-patches *.mpp
kveld9 kveld9/kveld-extra-morphe-patches *.mpp
frip Fripe070/PixivPatches *.mpp
madush madushas/morphe-patches-custom *.mpp

License

Revancex is licensed under the GNU General Public License v3.0.

About

Modern, high-performance Rust patcher & orchestrator for ReVanced, Morphe. Magisk and KernelSU modules with WebUI and dynamic config.

Topics

Resources

Stars

390 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages