revanced-manager/docs/2_1_patching.md

# 🧩 Patching apps

Learn how to use ReVanced Manager to patch apps.

## ✅ Steps to patch apps

1. Navigate to the **Patcher** tab from the bottom navigation bar
2. Tap on the **Select an app** card
3. Choose an app to patch[^1]

   > ℹ️ Note  
   > The suggested version is visible on each app's card.  
   > You can tap on it to open a search query to obtain an APK file for the selected app with the suggested version

   > 💡 Tip  
   > If you are prompted to select an APK file from storage because the selected app is a split APK, tap on the "Suggested version" label to open a search query to obtain said APK file

4. Tap on the **Select patches** card and select the patches you want to apply[^2].

   > ℹ️ Note  
   > Some patches have options that can or must be configured by tapping on ⚙️ icon next to the patch name.

   > ⚠️ Warning  
   > If you see a warning, you can click on it for more information.

5. Tap on the **Done** then **Patch** button

   > ⚠️ Warning  
   > The patching process may take ~5 minutes. Exiting the app may cancel patching or increase the time it takes to patch significantly.

6. Tap on the **Install** button

   > ℹ️ Note  
   > If you are rooted, you can mount the patched app on top of the original app.[^3]
   > Optionally, you may export the patched app to storage using the option in the bottom left corner.

[^1]: You can select installed apps or select APK files from storage. ReVanced does not provide any APK files, which is why you have to source them yourself.
[^2]: It is suggested to use the default set of patches by tapping on the **Default** button above the list of patches.
[^3]: Mounting the patched app on top of the original app will only work if the installed app version matches the version of the app selected in step 3. above.

## ⏭️ What's next

The next page will lead back to the usage page.

Continue: [🛠️ Usage](2_usage.md)