diff --git a/docs/1_usage.md b/docs/1_usage.md index c5a3a8d..e44a6a9 100644 --- a/docs/1_usage.md +++ b/docs/1_usage.md @@ -34,33 +34,33 @@ ReVanced CLI is divided into the following fundamental commands: revanced-patches.jar [ ...] ``` -> [!NOTE] -> A default `options.json` file will be automatically created if it does not exist -without any need for intervention when using the `patch` command. + > **ℹī¸ Note** + > A default `options.json` file will be automatically created if it does not exist + without any need for intervention when using the `patch` command. - ### 💉 Patch an app You can patch apps by supplying patch bundles and the app to patch. After patching, ReVanced CLI can install the patched app on your device using two methods: + + > **💡 Tip** + > For ReVanced CLI to be able to install the patched app on your device, make sure ADB is working: + > + > ```bash + > adb shell exit + > ``` + > + > If you want to mount the patched app on top of the un-patched app, make sure you have root permissions: + > + > ```bash + > adb shell su -c exit + > ``` + > -> [!NOTE] -> For ReVanced CLI to be able to install the patched app on your device, make sure ADB is working: -> -> ```bash -> adb shell exit -> ``` -> -> If you want to mount the patched app on top of the un-patched app, make sure you have root permissions: -> -> ```bash -> adb shell su -c exit -> ``` -> - -> [!WARNING] -> Some patches may require integrations -> such as [ReVanced Integrations](https://github.com/revanced/revanced-integrations). -> Supply them with the option `--merge`. ReVanced Patcher will automatically determine if they are necessary. + > **⚠ī¸ Warning** + > Some patches may require integrations + > such as [ReVanced Integrations](https://github.com/revanced/revanced-integrations). + > Supply them with the option `--merge`. ReVanced Patcher will automatically determine if they are necessary. - #### 👾 Patch an app and install it on your device regularly @@ -73,26 +73,12 @@ without any need for intervention when using the `patch` command. - #### 👾 Patch an app and mount it on top of the un-patched app with root permissions - > [!IMPORTANT] - > Ensure that the same app you are patching and mounting over is installed on your device: - > - > ```bash - > adb install app.apk - > ``` - - > [!NOTE] - > You can use the option `--ii` to include or `--ie` to exclude - > patches by their index in relation to supplied patch bundles, - > similarly to the option `--include` and `--exclude`. - > - > This is useful in case two patches have the same name, and you must include or exclude one. - > The patch index is calculated by the position of the patch in the list of patches - > from patch bundles supplied using the option `--patch-bundle`. - > - > You can list all patches with their indices using the command `list-patches`. - > - > Keep in mind that the indices can change based on the order of the patch bundles supplied, - > as well if the patch bundles are updated because patches can be added or removed. + > **❗ Caution** + > Ensure that the same app you are patching and mounting over is installed on your device: + > + > ```bash + > adb install app.apk + > ``` ```bash java -jar revanced-cli.jar patch \ @@ -104,6 +90,20 @@ without any need for intervention when using the `patch` command. --mount \ app.apk ``` + + > **💡 Tip** + > You can use the option `--ii` to include or `--ie` to exclude + > patches by their index in relation to supplied patch bundles, + > similarly to the option `--include` and `--exclude`. + > + > This is useful in case two patches have the same name, and you must include or exclude one. + > The patch index is calculated by the position of the patch in the list of patches + > from patch bundles supplied using the option `--patch-bundle`. + > + > You can list all patches with their indices using the command `list-patches`. + > + > Keep in mind that the indices can change based on the order of the patch bundles supplied, + > as well if the patch bundles are updated because patches can be added or removed. - ### 🗑ī¸ Uninstall an app @@ -113,9 +113,9 @@ without any need for intervention when using the `patch` command. [] ``` -> [!NOTE] -> You can unmount an APK file -by adding the option `--unmount`. + > **💡 Tip** + > You can unmount an APK file + by adding the option `--unmount`. - ### ī¸ đŸ“Ļ Install an app @@ -125,6 +125,6 @@ by adding the option `--unmount`. [] ``` -> [!NOTE] -> You can mount an APK file -> by supplying the package name of the app to mount the supplied APK file over the option `--mount`. + > **💡 Tip** + > You can mount an APK file + > by supplying the app's package name to mount the supplied APK file over the option `-mount`.