revanced-magisk-module

ReVanced is a community project that applies patches to popular Android apps, most notably YouTube and YouTube Music, to add features and remove limitations that are not available in the official versions. This repository is an automated builder that takes those ReVanced patches and packages the results either as Magisk modules or as standalone APK files that can be installed on Android devices.

Magisk is a tool for Android devices that have been rooted, meaning the user has gained elevated control over the operating system. Magisk modules are add-ons that modify how the device works at the system level. This project builds ReVanced as a Magisk module, which means the patched app integrates deeply with the existing stock app rather than replacing it entirely. The modules are built to avoid triggering SafetyNet and root detection checks that some apps run to block modified versions. For users without a rooted device, the builder can also produce regular APK files that are installed like any other app.

The build process runs automatically on a daily schedule using GitHub Actions, so releases stay current as ReVanced patches and app versions are updated. Configuration is handled through a file called config.toml, and a web-based tool called rvmm-config-gen helps customize which apps and patches to include without editing the file manually. Users who want a custom build can fork the repository, adjust the configuration, and trigger the build workflow to generate their own releases.

The project supports both Magisk and KernelSU, which are the two main frameworks Android root users choose between. Local builds are also possible on a Linux computer or directly on an Android device using Termux, a terminal application. A companion tool called zygisk-detach is recommended alongside the Magisk module version to prevent the Play Store from overwriting the patched app with an update.