Continuing the legacy of Vanced

ReVanced Patcher used to patch Android applications.

ReVanced Patcher is a library that is used to patch Android applications.
It powers ReVanced Manager, ReVanced CLI and ReVanced Library and a rich set of patches have been developed using ReVanced Patcher in the ReVanced Patches repository.

Some of the features the ReVanced Patcher provides are:

• 🔧 Patch Dalvik VM bytecode: Disassemble and assemble Dalvik bytecode
• 📦 Patch APK resources: Decode and build Android APK resources
• 📂 Patch arbitrary APK files: Read and write arbitrary files directly from and to APK files
• 🧩 Write modular patches: Extensive API to write modular patches that can patch Dalvik VM bytecode, APK resources and arbitrary APK files

To use ReVanced Patcher in your project, follow these steps:

1. Add the repository to your project

2. Add the dependency to your project:

    dependencies {
        implementation("app.revanced:revanced-patcher:{$version}")
    }

For a minimal project configuration, see ReVanced Patches template.

Thank you for considering contributing to ReVanced Patcher. You can find the contribution guidelines here.

To build ReVanced Patcher, you can follow the ReVanced documentation.

The documentation contains the fundamentals of ReVanced Patcher and how to use ReVanced Patcher to create patches. You can find it here.

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