🔍 ReVanced Downloader Plugins

May 28, 2025 · View on GitHub


                       

Continuing the legacy of Vanced

🔍 ReVanced Downloader Plugins

GitHub Workflow Status (with event) GPLv3 License

A collection of ReVanced Manager downloader plugins that fetch APKs from popular APK sources.

❓ About

This is a monorepo containing ReVanced Manager downloader plugins for fetching APKs from multiple popular sources. Each downloader is built as a separate module:

📦 Available Downloaders

  • 🪞 APKMirror Downloader (apkmirror-downloader) - Downloads from APKMirror.com
  • 🔵 APKPure Downloader (apkpure-downloader) - Downloads from APKPure.net
  • 🔴 APKCombo Downloader (apkcombo-downloader) - Downloads from APKCombo.com

🚀 Features

  • Single-source focus: Each downloader specializes in one APK source
  • Lightweight: Minimal dependencies and clean implementation
  • Reliable: Based on the proven APKMirror downloader architecture
  • Version support: All support specific version downloads or latest version

🏗️ Monorepo Structure

revanced-downloader-plugins/
├── apkmirror-downloader/          # APKMirror-only downloader
├── apkpure-downloader/            # APKPure-only downloader  
├── apkcombo-downloader/           # APKCombo-only downloader
├── build.gradle.kts               # Root build configuration
├── settings.gradle.kts            # Module definitions
└── .github/workflows/             # CI/CD for all modules

Each module produces its own APK plugin that can be installed independently in ReVanced Manager.

🧩 Implementation Details

Sources

  1. APKMirror

    • Searches for apps by package name
    • Navigates through search results to find the correct app
    • Handles version selection and download
    • Bypasses anti-scraping measures

  2. APKPure

    • Provides an alternative source for APKs
    • Supports version selection
    • Handles download initiation

  3. APKCombo

    • Third fallback option for APK downloads
    • Supports searching and version selection
    • Handles download links extraction

Technical Implementation

  • Uses WebView for navigating through sources
  • Implements Jsoup for HTML parsing
  • Uses Retrofit/OkHttp for direct download links
  • Implements coroutines for asynchronous operations
  • Provides download progress tracking

🧑‍💻 Usage

For Users

  1. Install the APK Sources Downloader plugin in ReVanced Manager
  2. When patching an app, select this plugin as the download source
  3. The plugin will automatically search for the app across all sources
  4. If a specific version is requested, the plugin will attempt to find that version
  5. The download will begin automatically once the APK is found

🛠️ Building

To build ReVanced downloader plugins, a Java Development Kit (JDK) and Git must be installed.
Follow the steps below to build ReVanced downloader plugins:

  1. Run git clone git@github.com:Aunali321/revanced-downloader-plugins.git to clone the repository
  2. Run gradlew assembleRelease to build the project

Note

If the build fails due to authentication, you may need to authenticate to GitHub Packages. Create a PAT with the scope read:packages here and add your token to ~/.gradle/gradle.properties.

Example gradle.properties file:

gpr.user = user
gpr.key = key

📜 License

ReVanced Downloader Plugins is licensed under the GPLv3 license. Please see the license file for more information. tl;dr you may copy, distribute and modify ReVanced Downloader Plugins as long as you track changes/dates in source files. Any modifications to ReVanced Downloader Plugins must also be made available under the GPL, along with build & install instructions.