📝 Updated Docs

This commit is contained in:
Nikhil Badyal
2022-08-23 13:55:19 +05:30
parent 2c030a0e9a
commit 71e4dea311
+95 -69
View File
@@ -1,65 +1,28 @@
# Docker-Py-ReVanced # Docker-Py-ReVanced
This little utility will help you in building all Revanced apps. A little python script that will help you in building [Revanced apps.](#note)
## Build ## Build
You can use any of the following methods to build You can use any of the following methods to build.
- With Docker <details>
1. Install Docker <summary>🚀In GitHub(Recommended)</summary>
2. Run script with
```shell
docker-compose up
```
- Without Docker
1. Install Java17 (zulu preferred)
2. Install Python
3. Create virtual environment
```python
python3 -m venv venv
```
4. Activate virtual environment
```python
source venv/bin/activate
```
5. Install Dependencies with
```python
pip install -r requirements.txt
```
6. Run the script with
```python
python main.py
```
- In GitHub
1. Fork the project. Add following secrets to the repo
1. Fork the project.
2. Add following secrets to the repo.
1. _GH_TOKEN_ (**required**) - GitHub token so that it can upload to GitHub 1. _GH_TOKEN_ (**required**) - GitHub token so that it can upload to GitHub
after building. after building.
2. _VT_API_KEY_ (required , only if you want Virus total scan) - So that it can send 2. _VT_API_KEY_ (optional) - required only if you want Virus total scan.
apks for VirusTotal Scan. 3. _ENVS_ (optional) - required only if you want to cook specific apps/versions.
3. _ENVS_ (optional) - If you want cook specific apps/versions <details>
```dotenv
PATCH_APPS=youtube,twitter,reddit
YOUTUBE_VERSION=latest
YOUTUBE_MUSIC_VERSION=latest
TWITTER_VERSION=latest
REDDIT_VERSION=latest
TIKTOK_VERSION=latest
WARNWETTER_VERSION=latest
```
Should look something like this in GitHub
4. <details>
<summary>Samples</summary> <summary>Samples</summary>
- **`Secrets`** should like this - **`GitHub Secrets`** might look like this
![img.png](img.png) ![img.png](img.png)
- **`ENVS`** secret can look something like this - **`ENVS`** secret might look like this
```
```python
PATCH_APPS=youtube_music,twitter PATCH_APPS=youtube_music,twitter
EXCLUDE_PATCH_YOUTUBE=custom-branding EXCLUDE_PATCH_YOUTUBE=custom-branding
EXCLUDE_PATCH_YOUTUBE_MUSIC=yt-music-is-shit EXCLUDE_PATCH_YOUTUBE_MUSIC=yt-music-is-shit
@@ -73,44 +36,107 @@ You can use any of the following methods to build
</details> </details>
2. Go to actions tab. Select `Build Revanced APK`.Click on `Run Workflow`. 3. Go to actions tab. Select `Build Revanced APK`.Click on `Run Workflow`.
## Note </details>
<details>
<summary>🐳With Docker</summary>
1. Install Docker
2. Run script with
```shell
docker-compose up
```
</details>
<details>
<summary>🫠Without Docker</summary>
1. Install Java17 (zulu preferred)
2. Install Python
3. Create virtual environment
```
python3 -m venv venv
```
4. Activate virtual environment
```
source venv/bin/activate
```
5. Install Dependencies with
```
pip install -r requirements.txt
```
6. Run the script with
```
python python main.py
```
</details>
### Note
By default, script build the version as recommended by Revanced team. By default, script build the version as recommended by Revanced team.
1. If you want to a specific version . Add the version in `environment` like 1. Supported values for **_<REVANCED_APPS_NAME>_** are :
```dotenv 1. youtube
2. youtube_music
3. twitter
4. reddit
5. tiktok
6. warnwetter
2. If you want to build a specific version . Add `version` in `environment` in the
format
```
<APPNAME>_VERSION=<VERSION>
```
Example:
```
YOUTUBE_VERSION=17.31.36 YOUTUBE_VERSION=17.31.36
YOUTUBE_MUSIC_VERSION=X.X.X YOUTUBE_MUSIC_VERSION=X.X.X
TWITTER_VERSION==X.X.X TWITTER_VERSION=X.X.X
REDDIT_VERSION==X.X.X REDDIT_VERSION=X.X.X
TIKTOK_VERSION=X.X.X TIKTOK_VERSION=X.X.X
WARNWETTER_VERSION=X.X.X WARNWETTER_VERSION=X.X.X
``` ```
2. If you want to a `latest` version, whatever latest is available(including beta) . 3. If you want to a `latest` version, whatever latest is available(including beta) .
Add `latest` in `environment` file like Add `latest` in `environment` in the format
```dotenv ```
<APPNAME>_VERSION=latest
```
Example:
```
YOUTUBE_VERSION=latest YOUTUBE_VERSION=latest
YOUTUBE_MUSIC_VERSION=latest YOUTUBE_MUSIC_VERSION=latest
TWITTER_VERSION==latest TWITTER_VERSION=latest
REDDIT_VERSION==latest REDDIT_VERSION=latest
TIKTOK_VERSION=latest TIKTOK_VERSION=latest
WARNWETTER_VERSION=latest WARNWETTER_VERSION=latest
``` ```
3. By default, it will build all build app supported by Revanced team. If you don't 4. By default, it will build [all](#note) build app supported by Revanced team. If you
want to waste time and build only few apps. Add following(the apps you want to don't
build) `environment`. want to waste time and build only few apps. Add the apps you want to build in
```dotenv `environment` in the format
```
PATCH_APPS=<REVANCED_APPS_NAME>
```
Example:
```
PATCH_APPS=youtube,twitter,reddit PATCH_APPS=youtube,twitter,reddit
``` ```
4. If you don't want to use default keystore. You can provide your own by placing it 5. If you don't want to use default keystore. You can provide your own by placing it
inside `apks` folder. And adding the name of file in `environment` inside `apks` folder. And adding the name of `keystore-file` in `environment` like
```dotenv ```
KEYSTORE_FILE_NAME=revanced.keystore KEYSTORE_FILE_NAME=revanced.keystore
``` ```
5. If you want to exclude any patch. Set comma separated environment variable like 6. If you want to exclude any patch. Set comma separated patch in `environment` in
```dotenv the format
```
EXCLUDE_PATCH_<REVANCED_APPS_NAME>=<PATCH_TO_EXCLUDE-1,PATCH_TO_EXCLUDE-2>
```
Example:
```
EXCLUDE_PATCH_YOUTUBE=custom-branding,hide-get-premium EXCLUDE_PATCH_YOUTUBE=custom-branding,hide-get-premium
EXCLUDE_PATCH_YOUTUBE_MUSIC=yt-music-is-shit EXCLUDE_PATCH_YOUTUBE_MUSIC=yt-music-is-shit
``` ```