├── README.md ├── docs ├── announcement.md ├── information-about-patches.md ├── revanced-cli.md ├── revancify.md ├── rvx-builder (android).md ├── rvx-builder (pc).md ├── rvx-manager.md └── supplying-an-apk.md └── images ├── apkmirror_youtube.png ├── platform-icons ├── crowdin-logo-dark.png ├── crowdin-logo-white.png ├── discord-mark-blue.png ├── github-mark-white.png ├── github-mark.png ├── reddit-logo-flat-circle.png └── telegram-logo.png ├── revancify_1.gif ├── revancify_2.png ├── revancify_3.png ├── revancify_4.png ├── rvx_manager_1.png ├── rvx_manager_2.png ├── rvx_manager_3.png └── rvx_manager_4.png /README.md: -------------------------------------------------------------------------------- 1 | # ReVanced Extended Documentation 2 | 3 | Instructions to build and install ReVanced Extended. 4 | ___ 5 | # Announcement on the current state of development 6 | - [Announcement](/docs/announcement.md) 7 | ___ 8 | # Docs 9 | 10 | - [Supplying-an-APK](/docs/supplying-an-apk.md) 11 | - [Method 1. RVX Manager (Android)](/docs/rvx-manager.md) 12 | - [Requirements](/docs/rvx-manager.md#requirements) 13 | - [Using RVX Manager](/docs/rvx-manager.md#using-rvx-manager) 14 | - [Method 2. RVX Builder (PC)](/docs/rvx-builder%20(pc).md) 15 | - [Requirements](/docs/rvx-builder%20(pc).md#requirements) 16 | - [Using RVX Builder (PC)](/docs/rvx-builder%20(pc).md#using-rvx-builder-windows--macos--linux) 17 | - [Method 3. RVX Builder (Android - Termux)](/docs/rvx-builder%20(android).md) 18 | - [Installing RVX Builder (Android)](/docs/rvx-builder%20(android).md#installing-rvx-builder-for-the-first-time) 19 | - [Using RVX Builder (Android)](/docs/rvx-builder%20(android).md#using-rvx-builder-termux) 20 | - [Additional info](/docs/rvx-builder%20(android).md#additional-info) 21 | - [Troubleshooting RVX Builder](/docs/rvx-builder%20(android).md#troubleshooting) 22 | - [Method 4. Revancify (Android - Termux)](/docs/revancify.md) 23 | - [Installing Revancify](/docs/revancify.md#installing-revancify-for-the-first-time) 24 | - [Using Revancify](/docs/revancify.md#patching) 25 | - [Method 5. ReVanced CLI (PC)](/docs/revanced-cli.md) 26 | - [Requirements](/docs/revanced-cli.md#requirements) 27 | - [Preparing the packages](/docs/revanced-cli.md#preparing-the-packages) 28 | - [Using ReVanced CLI](/docs/revanced-cli.md#using-revanced-cli-pc) 29 | - [Non-ROOT installations](/docs/revanced-cli.md#non-root-installations) 30 | - [ROOT installations](/docs/revanced-cli.md#root-installations) 31 | - [Information about the patches](/docs/information-about-patches.md) 32 | ___ 33 | # Patch Information with Screenshots 34 | 35 | - [ReVanced-Extended-Community/Patches-Documentation](https://github.com/ReVanced-Extended-Community/Patches-Documentation#patches-with-screenshots) 36 | ___ 37 |

38 | 39 | 40 | 41 | 42 | 43 |     44 | 45 | 46 | 47 | 48 | 49 |     50 | 51 | 52 | 53 | 54 | 55 |     56 | 57 | 58 | 59 | 60 | 61 |     62 | 63 | 64 | 65 | 66 | 67 |     68 | 69 | 70 | 71 | 72 | 73 |     74 | 75 | 76 | 77 | 78 | 79 |     80 | 81 | 82 | 83 | 84 | 85 |     86 |

-------------------------------------------------------------------------------- /docs/announcement.md: -------------------------------------------------------------------------------- 1 | # ReVanced Extended is currently active. 2 | 3 | Please refer to the [release notes](https://github.com/inotia00/revanced-patches/releases/latest) in the revanced-patches repository. -------------------------------------------------------------------------------- /docs/information-about-patches.md: -------------------------------------------------------------------------------- 1 | Information about the patches 2 | == 3 | 4 | The patch list for each app can be found using these links: 5 | 6 | [**YouTube**](https://github.com/inotia00/revanced-patches/tree/revanced-extended#-comgoogleandroidyoutube) 7 | 8 | [**YouTube Music**](https://github.com/inotia00/revanced-patches/tree/revanced-extended#-comgoogleandroidappsyoutubemusic) 9 | 10 | [**Reddit**](https://github.com/inotia00/revanced-patches/tree/revanced-extended#-comredditfrontpage) 11 | 12 | 13 | 14 | Patches that need to be enabled or disabled depending on the situation: 15 | == 16 | 17 | ### If you want the ROOT YouTube/YT Music version: 18 | 19 | - Disable the `GmsCore support` patch. 20 | 21 | Using CLI: `-d "GmsCore support"` 22 | 23 | ### If you want a custom app icon: 24 | 25 | - Enable the `Custom branding icon YouTube` / `Custom branding icon YouTube Music` patch. 26 | 27 | Using CLI: `-e "Custom branding icon YouTube"` / `-e "Custom branding icon YouTube Music"` 28 | 29 | ※ You can choose the custom icon by opening `options.json` in an editor. (Available values: `MMT`, `Revancify Blue`, `Revancify Red`, or you can enter the absolute path where the icon file exists.) 30 | 31 | ### If you want the official app icon: 32 | 33 | - Disable the `Custom branding icon YouTube` / `Custom branding icon YouTube Music` patch. 34 | 35 | Using CLI: `-d "Custom branding icon YouTube"` / `-d "Custom branding icon YouTube Music"` 36 | 37 | ### If you want a custom app name: 38 | 39 | - Enable the `Custom branding name YouTube` / `Custom branding name YouTube Music` / `Custom branding name Reddit` patch. 40 | 41 | Using CLI: `-e "Custom branding name YouTube"` / `-e "Custom branding name YouTube Music"` / `-e "Custom branding name Reddit"` 42 | 43 | ※ You can choose the custom app name by opening `options.json` in an editor. (Default: ReVanced Extended) 44 | 45 | ### If you want the official app name: 46 | 47 | - Disable the `Custom branding name YouTube` / `Custom branding name YouTube Music` / `Custom branding name Reddit` patch. 48 | 49 | Using CLI: `-d "Custom branding name YouTube"` / `-d "Custom branding name YouTube Music"` / `-d "Custom branding name Reddit"` 50 | 51 | ### If you want the standard YouTube theme: 52 | 53 | - Disable the `Theme` and `MaterialYou` patches. 54 | 55 | Using CLI: `-d "Theme" -d "MaterialYou"` 56 | 57 | ### If you want a custom YouTube theme: 58 | 59 | (Custom light theme + Custom dark theme) 60 | 61 | - Enable the `Theme` patch. 62 | 63 | - Disable the `MaterialYou` patch. 64 | 65 | Using CLI: `-e "Theme" -d "MaterialYou"` 66 | 67 | ※ You can choose the custom theme colors by opening `options.json` in an editor and specifying the HEX colors. (Default dark theme: Amoled Black) 68 | 69 | ### If you want a MaterialYou theme in YouTube (only on Android 12+): 70 | 71 | (MaterialYou light theme + MaterialYou dark theme) 72 | 73 | - Disable the `Theme` patch. 74 | 75 | - Enable the `MaterialYou` patch. 76 | 77 | Using CLI: `-d "Theme" -e "MaterialYou"` 78 | 79 | ### If you want a MaterialYou theme + Custom dark theme in YouTube (only on Android 12+): 80 | 81 | (Material light theme + Custom dark theme) 82 | 83 | - Enable the `Theme` and `MaterialYou` patches. 84 | 85 | Using CLI: `-e "Theme" -e "MaterialYou"` 86 | 87 | ※ You can choose the custom dark theme color by opening `options.json` in an editor and specifying the HEX color. (Default dark theme: Amoled Black) 88 | -------------------------------------------------------------------------------- /docs/revanced-cli.md: -------------------------------------------------------------------------------- 1 | Requirements 2 | == 3 | 4 | - x86/x86_64 host architecture 5 | - [Zulu JDK 17](https://www.azul.com/downloads/?version=java-17-lts&package=jdk#zulu) 6 | - ADB (only required for ROOT installations) 7 | 8 | 9 | Preparing the packages 10 | == 11 | 12 | 1. Follow the steps on [this page](https://github.com/inotia00/revanced-documentation/blob/main/docs/supplying-an-apk.md) to supply and prepare an APK to patch. You can supply a full APK (`.apk`) or a split/bundle APK (`.apkm`, `.apks`, `.xapk`, etc.). 13 | 14 | 2. Download the following packages to your PC: 15 | - [ReVanced CLI](https://github.com/inotia00/revanced-cli/releases/latest) 16 | - [ReVanced Patches](https://github.com/inotia00/revanced-patches/releases/latest) (`.rvp`file) 17 | 18 | 3. (Optional): For simplicity, place the APK you downloaded from APKMirror and the packages you downloaded in a folder named `revanced-extended`. 19 | 20 | 21 | Using ReVanced CLI (PC) 22 | == 23 | 24 | ## Non-ROOT installations 25 | 26 | **Running the CLI:** 27 | 28 | - For YouTube (and Reddit), use the option '--rip-lib' to remove unwanted architectures. (e.g. `--rip-lib=x86 --rip-lib=x86_64` ...) 29 | - The option '-d' allows you to disable patches. (e.g. `-d "Theme"` ...) 30 | - The option '-e' allows you to enable patches. (e.g. `-e "MaterialYou"` `-e "GmsCore support"` ...) 31 | - The option 'list-patches' will show the list of available patches. (e.g. `java -jar revanced-cli.jar list-patches patches.rvp` ...) 32 | - The option 'options' allows you to generate options file. (e.g. `java -jar revanced-cli.jar options patches.rvp` ...) 33 | - The option 'patches' allows you to generate patches file. (e.g. `java -jar revanced-cli.jar patches patches.rvp` ...) 34 | 35 | ``` 36 | java -jar revanced-cli-all.jar patch \ 37 | -p patches.rvp \ 38 | --legacy-options=options.json \ 39 | --purge \ 40 | -o revanced-extended.apk \ 41 | input.apk 42 | ``` 43 | 44 | > [!NOTE] 45 | > 46 | > If using a split/bundle APK, be sure to specify the file extension for the input APK (e.g. `input.apkm`, `input.apks`, `input.xapk`, etc.). 47 | 48 | After patching is complete, install `revanced-extended.apk` from the `revanced-extended` folder to your Android device. 49 | 50 | ## ROOT installations 51 | 52 | **1. Make sure your phone is connected to ADB** 53 | 54 | **2. Check if you have root access:** 55 | ``` 56 | adb shell su -c exit 57 | ``` 58 | 59 | **3. Copy the ADB device name:** 60 | ``` 61 | adb devices 62 | ``` 63 | 64 | > **If you haven't done so already, install YouTube / YT Music on your device:** 65 | > ``` 66 | > adb install -r input.apk 67 | > ``` 68 | 69 | **4. Running the CLI:** 70 | 71 | - For YouTube, use the option '--rip-lib' to remove unwanted architectures. (e.g. `--rip-lib=x86 --rip-lib=x86_64` ...) 72 | - For ROOT installs, you must disable the 'GmsCore support' patch using the option '-d'. 73 | - The option '-d' allows you to disable patches. (e.g. `-d "GmsCore support"` `-d "Theme"` ...) 74 | - The option '-e' allows you to enable patches. (e.g. `-e "MaterialYou"` ...) 75 | - The option 'list-patches' will show the list of available patches. (e.g. `java -jar revanced-cli.jar list-patches patches.rvp` ...) 76 | - The option 'options' allows you to generate options file. (e.g. `java -jar revanced-cli.jar options patches.rvp` ...) 77 | - The option 'patches' allows you to generate patches file. (e.g. `java -jar revanced-cli.jar patches patches.rvp` ...) 78 | 79 | ``` 80 | java -jar revanced-cli-all.jar patch \ 81 | -d device-name \ 82 | -p patches.rvp \ 83 | --legacy-options=options.json \ 84 | --purge \ 85 | -d "GmsCore support" \ 86 | --mount \ 87 | -o revanced-extended.apk \ 88 | input.apk 89 | ``` 90 | 91 | > [!NOTE] 92 | > 93 | > If using a split/bundle APK, be sure to specify the file extension for the input APK (e.g. `input.apkm`, `input.apks`, `input.xapk`, etc.). 94 | 95 | > [!TIP] 96 | > I recommend also installing the [Detach Magisk module](https://forum.xda-developers.com/t/module-detach3-detach-market-links.3447494/). It prevents automatic updates from the Google Play Store, which would cause crashes to occur in the ROOT environment. 97 | -------------------------------------------------------------------------------- /docs/revancify.md: -------------------------------------------------------------------------------- 1 | About Revancify 2 | == 3 | 4 | Revancify is a tool for building ReVanced in Termux. It is developed by [@decipher3114](https://github.com/decipher3114). Visit the [Revancify repository](https://github.com/decipher3114/Revancify) for more info. 5 | 6 | 7 | Installing Revancify for the first time 8 | = 9 | 10 | 1. Install [Termux](https://github.com/termux/termux-app/releases/latest). 11 | 12 | 2. Open Termux and run this command to install Revancify: 13 | 14 | ``` 15 | curl -sL https://github.com/decipher3114/Revancify/raw/refs/heads/main/install.sh | bash 16 | ``` 17 | 18 | 19 | #### Usage 20 | After Revancify is installed, type `revancify` in Termux and press `Enter` to run it. 21 | 22 | > [!TIP] 23 | > It can also be ran with arguments. See the available arguments with `revancify -h`. 24 | 25 | > [!TIP] 26 | > You can also use my shortcut to quickly open Revancify. Find out more [here](https://github.com/inotia00/RevancifyShortcut?tab=readme-ov-file#shortcut-for-revancify). 27 | 28 | 29 | Patching 30 | == 31 | 32 | 1. From the Revancify menu, select `Change Source` and select `ReVanced-Extended`. Then, press `Done`. 33 | 34 | 2. Select `Update Assets` to download the latest CLI and patch files. 35 | 36 | 37 | 38 | 39 | 3. Select `Patch App` and choose the app you want to auto-download and patch. From the Version Selection Menu, choose the `Auto Select` option or a version labeled `[RECOMMENDED]`. 40 | 41 | 42 | 43 | > [!IMPORTANT] 44 | > If there is no `Auto Select` or `[RECOMMENDED]` option, follow the steps on [this page](https://github.com/inotia00/revanced-documentation/blob/main/docs/supplying-an-apk.md). Then, move the APK you downloaded into `Internal storage/Revancify/Stock`. Then, return to Revancify and press `Import` to import the APK you placed in the `Stock` directory. 45 | > 46 | > 47 | 48 | 4. Choose patches to include or exclude. If you aren't sure, just press `Recommended`. 49 | 50 | - Read [this document](https://github.com/inotia00/revanced-documentation/blob/main/docs/information-about-patches.md) for information on patches you may want to include or exclude. 51 | 52 | > [!IMPORTANT] 53 | > For ROOT YouTube / YT Music installations, the `GmsCore support` patch must be excluded. For non-ROOT installations, the patch must be included. 54 | > 55 | > 56 | 57 | 5. After selecting the patches you can configure the patch options (options.json). After they are set to your liking, press `Done` to begin patching. 58 | 59 | 6. Install the patched APK when prompted. (The patched APK will also be saved in `Internal storage > Revancify > Patched`.) 60 | 61 | > [!TIP] 62 | > For ROOT installations, I recommend also installing the [Detach Magisk module](https://forum.xda-developers.com/t/module-detach3-detach-market-links.3447494/). It prevents automatic updates from the Google Play Store, which would cause crashes to occur in the ROOT environment. 63 | -------------------------------------------------------------------------------- /docs/rvx-builder (android).md: -------------------------------------------------------------------------------- 1 | Installing RVX Builder for the first time 2 | == 3 | 4 | 1. Install [Termux](https://github.com/termux/termux-app/releases/latest). 5 | 6 | 2. Open Termux and run these commands: 7 | 8 | ``` 9 | curl -sLo rvx-builder.sh https://raw.githubusercontent.com/inotia00/rvx-builder/revanced-extended/android-interface.sh && chmod +x rvx-builder.sh && ./rvx-builder.sh 10 | ``` 11 | 12 | > [!TIP] 13 | > 14 | > If an error occurs, enter it line by line: 15 | > 16 | > ``` 17 | > curl -sLo rvx-builder.sh https://raw.githubusercontent.com/inotia00/rvx-builder/revanced-extended/android-interface.sh 18 | > ``` 19 | > ``` 20 | > chmod +x rvx-builder.sh 21 | > ``` 22 | > ``` 23 | > ./rvx-builder.sh 24 | > ``` 25 | 26 | > [!NOTE] 27 | > 28 | > During initial installation, Termux may ask if you want to update additional packages. (Enter `Y` or `N`.) 29 | 30 | After installing, rvx-builder will run automatically. 31 | 32 | 33 | Using RVX Builder (Termux) 34 | == 35 | 36 | > [!NOTE] 37 | > ### If you are preparing to install in a ROOT environment: 38 | > 39 | > Follow the steps on [this page](https://github.com/inotia00/revanced-documentation/blob/main/docs/supplying-an-apk.md) to prepare the device for a mount installation. Note that the APK from APKMirror that you install must be the same version as the APK you will patch. 40 | > 41 | > Also, Termux must have superuser permissions granted. 42 | 43 | 44 | 1. Run rvx-builder with either of these commands in Termux: 45 | 46 | ``` 47 | rvx 48 | ``` 49 | or 50 | ``` 51 | ./rvx-builder.sh run 52 | ``` 53 | 54 | 2. A GUI will open in your browser. Click `Start patching`. After the dependencies are downloaded, click `Continue`. 55 | 56 | 3. Select the app you want to patch, or upload the APK. 57 | 58 | 4. Select the patches you want to include. 59 | 60 | - Read [this document](https://github.com/inotia00/revanced-documentation/blob/main/docs/information-about-patches.md) for information on patches you may want to include or exclude. Otherwise, just click the `Select All` button to select all Default patches. 61 | 62 | > [!IMPORTANT] 63 | > For ROOT YouTube / YT Music installations, the `GmsCore support` patch must be excluded. In non-ROOT environments the patch will be hidden and included automatically. 64 | 65 | 5. If you did not upload an APK in step 3, a menu will appear where you can choose the version of the app to patch. Select the first option, marked `(AUTO SELECTION)`, or select a version marked as `(suggested)`. After the APK is downloaded, click `Continue` and wait for patching to complete. 66 | 67 | 6. For non-ROOT installations, the patched APK will be saved to your device and it must be manually installed. The path to the APK will be displayed at the bottom of the patch log. For ROOT installations, the app will be mounted automatically. 68 | 69 | > [!TIP] 70 | > For ROOT installations, I recommend also installing the [Detach Magisk module](https://forum.xda-developers.com/t/module-detach3-detach-market-links.3447494/). It prevents automatic updates from the Google Play Store, which would cause crashes to occur in the ROOT environment. 71 | 72 | 73 | Additional info 74 | == 75 | 76 | ### Updating rvx-builder: 77 | 78 | To update rvx-builder, run either of these commands in Termux: 79 | ``` 80 | rvxup 81 | ``` 82 | or 83 | ``` 84 | ./rvx-builder.sh update && ./rvx-builder.sh run 85 | ``` 86 | 87 | ### Reinstalling rvx-builder: 88 | 89 | To reinstall rvx-builder, run either of these commands in Termux: 90 | ``` 91 | rvxre 92 | ``` 93 | or 94 | ``` 95 | ./rvx-builder.sh reinstall && ./rvx-builder.sh run 96 | ``` 97 | 98 | ### Configuring `options.json`: 99 | 100 | Open `options.json` in an editor by running the `opon` command in Termux. After making the desired changes, enter `CTRL + X` to save and close the editor. 101 | 102 | Troubleshooting 103 | == 104 | **1. If encountering an error when installing rvx-builder for the first time:** 105 | 106 | - Ensure that Termux is not the Play Store version of Termux 107 | - Try reinstalling Termux 108 | - Try changing networks and disabling any VPN / adblockers, etc. 109 | - Try entering the following command: 110 | ``` 111 | apt-get autoremove nodejs-lts -y && pkg install nodejs-lts -y && apt-get autoremove openjdk-17 -y && pkg install openjdk-17 -y && ./rvx-builder.sh run 112 | ``` 113 | 114 | **2. If rvx-builder worked in the past, but an issue occurred when using it again:** 115 | 116 | - Try reinstalling rvx-builder with the following command: 117 | ``` 118 | ./rvx-builder.sh reinstall && ./rvx-builder.sh run 119 | ``` 120 | or 121 | ``` 122 | rvxre 123 | ``` 124 | 125 | **3. If an issue occurs during the patching process:** 126 | 127 | - Ensure that Termux has battery optimization exclusions 128 | - Reinstall rvx-builder with the following command: 129 | ``` 130 | ./rvx-builder.sh reinstall && ./rvx-builder.sh run 131 | ``` 132 | or 133 | ``` 134 | rvxre 135 | ``` 136 | 137 | ___ 138 | - If you encounter any other issues, please report them on the [GitHub issues page](https://github.com/inotia00/rvx-builder/issues). -------------------------------------------------------------------------------- /docs/rvx-builder (pc).md: -------------------------------------------------------------------------------- 1 | > [!NOTE] 2 | > ### If you are preparing to install in a ROOT environment: 3 | > 4 | > Follow the steps on [this page](https://github.com/inotia00/revanced-documentation/blob/main/docs/supplying-an-apk.md) to prepare the device for a mount installation. Note that the APK from APKMirror that you install must be the same version as the APK you will patch. 5 | > 6 | > You will also need your Android device connected to your PC via ADB. 7 | 8 | 9 | Using RVX Builder (Windows / MacOS / Linux) 10 | == 11 | 12 | 1. Download the [rvx-builder executable](https://github.com/inotia00/rvx-builder/releases/latest) and run it. 13 | 14 | > [!TIP] 15 | > 16 | > If you encounter an error, please refer to [this issue](https://github.com/inotia00/rvx-builder/issues/7). If your issue is not dicussed there, please report it on the [GitHub issues page](https://github.com/inotia00/rvx-builder/issues). 17 | 18 | 2. A GUI will open in your browser. Click `Start patching`. After the dependencies are downloaded, click `Continue`. 19 | 20 | 3. Select the app you want to patch, or upload the APK. 21 | 22 | 4. Select the patches you want to include. 23 | 24 | - Read [this document](https://github.com/inotia00/revanced-documentation/blob/main/docs/information-about-patches.md) for information on patches you may want to include or exclude. Otherwise, just click the `Select All` button to select all Default patches. 25 | 26 | > [!IMPORTANT] 27 | > 28 | > For ROOT YouTube / YT Music installations, the `GmsCore support` patch must be excluded. For non-ROOT installations, the patch must be included. 29 | 30 | 5. If you did not upload an APK in step 3, a menu will appear where you can choose the version of the app to patch. Select the first option, marked `(AUTO SELECTION)`, or select a version marked as `(suggested)`. After the APK is downloaded, click `Continue` and wait for patching to complete. 31 | 32 | 6. For non-ROOT installations, install the patched APK from the `revanced` folder to your Android device. The `revanced` folder will be in the same directory as the rvx-builder executable. For ROOT installations, the app will be mounted automatically. 33 | 34 | > [!TIP] 35 | > For ROOT installations, I recommend also installing the [Detach Magisk module](https://forum.xda-developers.com/t/module-detach3-detach-market-links.3447494/). It prevents automatic updates from the Google Play Store, which would cause crashes to occur in the ROOT environment. 36 | 37 | 38 | ___ 39 | - [How to use rvx-builder on Android](https://github.com/inotia00/revanced-documentation/blob/main/docs/rvx-builder%20(android).md) -------------------------------------------------------------------------------- /docs/rvx-manager.md: -------------------------------------------------------------------------------- 1 | Requirements 2 | == 3 | 4 | - Your device's architecture must be arm64-v8a, armeabi-v7a, or x86-64. 5 | - Your device must be running Android 8+. 6 | 7 | 8 | Using RVX Manager 9 | == 10 | 11 | 1. Follow the steps on [this page](https://github.com/inotia00/revanced-documentation/blob/main/docs/supplying-an-apk.md) to supply and prepare an APK to patch. 12 | 13 | 14 | 2. Download [RVX Manager](https://github.com/inotia00/revanced-manager/releases/latest) from GitHub and install it on your device. 15 | 16 | 17 | 3. Launch RVX Manager, click `Patcher` and then `Select an application`. 18 | 19 | 20 | 21 | 22 | 4. (Non-ROOT installations): Click the `Storage` button at the bottom right and select the APK downloaded from APKMirror. 23 | 24 | 25 | 26 | 27 | 4. (ROOT installations): Click the card for the application you installed. 28 | 29 | 30 | 31 | 32 | 5. Click `Selected patches` and include or exclude the patches you want. 33 | 34 | 35 | 36 | 37 | - Read [this document](https://github.com/inotia00/revanced-documentation/blob/main/docs/information-about-patches.md) for information on patches you may want to include or exclude. Otherwise, just click the `Default` button. 38 | 39 | > [!IMPORTANT] 40 | > For ROOT YouTube / YT Music installations, the `GmsCore support` patch must be excluded. For non-ROOT installations, the patch must be included. 41 | 42 | - When satisfied with your patch selection, click the `Done` button, and then the `Patch` button. 43 | 44 | 45 | 6. Install the patched APK. 46 | 47 | > [!TIP] 48 | > For ROOT installations, I recommend also installing the [Detach Magisk module](https://forum.xda-developers.com/t/module-detach3-detach-market-links.3447494/). It prevents automatic updates from the Google Play Store, which would cause crashes to occur in the ROOT environment. 49 | -------------------------------------------------------------------------------- /docs/supplying-an-apk.md: -------------------------------------------------------------------------------- 1 | ### 1. Check the supported app versions 2 | 3 | Check the JSON format in the [README.md](https://github.com/inotia00/revanced-patches/tree/revanced-extended#-json-format) of the revanced-patches repository to see which app versions are supported. 4 | 5 | > [!TIP] 6 | > 7 | > If you are confused by the JSON, here is an explanation: 8 | > - The supported YouTube versions are listed by `com.google.android.youtube` 9 | > - The supported YT Music versions are listed by `com.google.android.apps.youtube.music` 10 | > - The supported Reddit versions are listed by `com.reddit.frontpage` 11 | > 12 | > If there are no listed supported versions for one of the apps it means that the patches are not constrained to specific versions, and that a wide range of versions are expected to work. 13 | 14 | 15 | ### 2. Download a supported version of YouTube / YT Music / Reddit 16 | 17 | Go to [apkmirror.com](https://www.apkmirror.com/) and download a supported version of the app you want to patch. 18 | 19 | 20 | 21 | The architecture of the APK must be compatible with the device you plan to install the patched APK on. 22 | 23 | > [!NOTE] 24 | > ### If you are patching Reddit: 25 | > 26 | > Do not install the APK you downloaded from APKMirror. (Reddit should not be mounted.) 27 | 28 | 29 | > [!NOTE] 30 | > ### If you are patching Reddit with the RVX Manager: 31 | > 32 | > If you want to patch a Reddit version newer than 2024.29.0 with the RVX Manager, you will need to convert the split/bundle APK (`.apkm`, `.apks`, `.xapk`, etc.) into a `.apk` using an anti-splitting tool, such as [AntiSplit M](https://github.com/AbdurazaaqMohammed/AntiSplit-M). 33 | 34 | 35 | > [!NOTE] 36 | > ### If you are preparing to install in a ROOT environment: 37 | > 38 | > 1. Remove all YouTube related modules. 39 | > 2. Remove the following directories: `/data/adb/service.d`, `/data/adb/post-fs-data.d`, `/data/adb/revanced` 40 | > 3. Reboot device. 41 | > 4. Install the YouTube / YT Music APK you downloaded from APKMirror. 42 | -------------------------------------------------------------------------------- /images/apkmirror_youtube.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/apkmirror_youtube.png -------------------------------------------------------------------------------- /images/platform-icons/crowdin-logo-dark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/platform-icons/crowdin-logo-dark.png -------------------------------------------------------------------------------- /images/platform-icons/crowdin-logo-white.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/platform-icons/crowdin-logo-white.png -------------------------------------------------------------------------------- /images/platform-icons/discord-mark-blue.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/platform-icons/discord-mark-blue.png -------------------------------------------------------------------------------- /images/platform-icons/github-mark-white.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/platform-icons/github-mark-white.png -------------------------------------------------------------------------------- /images/platform-icons/github-mark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/platform-icons/github-mark.png -------------------------------------------------------------------------------- /images/platform-icons/reddit-logo-flat-circle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/platform-icons/reddit-logo-flat-circle.png -------------------------------------------------------------------------------- /images/platform-icons/telegram-logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/platform-icons/telegram-logo.png -------------------------------------------------------------------------------- /images/revancify_1.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/revancify_1.gif -------------------------------------------------------------------------------- /images/revancify_2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/revancify_2.png -------------------------------------------------------------------------------- /images/revancify_3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/revancify_3.png -------------------------------------------------------------------------------- /images/revancify_4.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/revancify_4.png -------------------------------------------------------------------------------- /images/rvx_manager_1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/rvx_manager_1.png -------------------------------------------------------------------------------- /images/rvx_manager_2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/rvx_manager_2.png -------------------------------------------------------------------------------- /images/rvx_manager_3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/rvx_manager_3.png -------------------------------------------------------------------------------- /images/rvx_manager_4.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/inotia00/revanced-documentation/c6807762c903cd7a59c7bbe0fdfa1134f4f6fdf5/images/rvx_manager_4.png --------------------------------------------------------------------------------