revanced-cli/docs/1_usage.md
2023-01-13 00:13:45 +01:00

1.7 KiB

🛠️ Using the ReVanced CLI

Lean how to use the ReVanced CLI.

Setup (optional)

  1. Make sure your device is connected

    adb shell exit
    

    If you plan to use the root variant, check if you have root access

    adb shell su -c exit
    
  2. Copy the ADB device name

    adb devices
    

🔨 ReVanced CLI Usage

  • Show all available options for the ReVanced CLI

    java -jar revanced-cli.jar -h
    
  • List all available patches from supplied patch bundles

    java -jar revanced-cli.jar \
        -b revanced-patches.jar \
        -l
    
  • Use the ReVanced CLI without root permissions

    java -jar revanced-cli.jar \
     -a input.apk \
     -c \
     -o unpatched-output.apk \
     -b revanced-patches.jar
    
  • Mount the patched application with root permissions over the installed application

    adb install input.apk # make sure the same version is installed
    java -jar revanced-cli.jar \
        -a input.apk \
        -c \
        -d device-name \
        -o patched-output.apk \
        -b revanced-patches.jar \
        -e microg-support \
        --mount
    

Note

:

  • If you want to exclude patches, you can use the option -e. In the case of YouTube, you have to exclude the microg-support patch from ReVanced Patches with the option -e microg-support.

  • Some patches from ReVanced Patches also might require ReVanced Integrations. Supply them with the option -m.

  • If you supplied a device with the option -d, the patched application will be automatically installed on the device.