📝 Updated Doc for GitHub env

This commit is contained in:
Nikhil Badyal
2022-08-22 23:48:29 +05:30
parent 2bcd0a6b3a
commit 096f8ccc2a
+76 -45
View File
@@ -1,87 +1,118 @@
# Docker Py ReVanced # Docker Py ReVanced
This little utility will help you in building all revanced apps. This little utility will help you in building all revanced apps.
## Build ## Build
You can use any of the following methods to build You can use any of the following methods to build
- With Docker - With Docker
1. Install Docker 1. Install Docker
2. Run script with 2. Run script with
```shell ```shell
docker-compose up docker-compose up
``` ```
- Without Docker - Without Docker
1. Install Java17 (zulu preferred) 1. Install Java17 (zulu preferred)
2. Install Python 2. Install Python
3. Create virtual environment 3. Create virtual environment
```python ```python
python3 -m venv venv python3 -m venv venv
``` ```
4. Activate virtual environment 4. Activate virtual environment
```python ```python
source venv/bin/activate source venv/bin/activate
``` ```
3. Install Dependencies with 5. Install Dependencies with
```python ```python
pip install -r requirements.txt pip install -r requirements.txt
``` ```
4. Run the script with 6. Run the script with
```python ```python
python main.py python main.py
``` ```
- In GitHub - In GitHub
1. Fork the project. Add following secrets to the repo
1. _GH_TOKEN_ (**required**) - Github token so that it can upload to github after building. 1. Fork the project. Add following secrets to the repo
1. _GH_TOKEN_ (**required**) - GitHub token so that it can upload to GitHub
after building.
2. _VT_API_KEY_ (required , only if you want Virus total scan) - So that it can send 2. _VT_API_KEY_ (required , only if you want Virus total scan) - So that it can send
apks for VirusTotal Scan. apks for VirusTotal Scan.
3. _ENVS_ (optional) - If you want cook specific apps/versions 3. _ENVS_ (optional) - If you want cook specific apps/versions
```dotenv ```dotenv
PATCH_APPS=youtube,twitter,reddit PATCH_APPS=youtube,twitter,reddit
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
``` ```
Should look something like this in GitHub Should look something like this in GitHub
4. <details>
<summary>Samples</summary>
- **`Secrets`** should like this
![img.png](img.png) ![img.png](img.png)
2. Go to actions tab. Select `Build Revanced APK`.Click on `Run Workflow`.
- **`ENVS`** secret can look something like this
```python
PATCH_APPS=youtube_music,twitter
EXCLUDE_PATCH_YOUTUBE=custom-branding
EXCLUDE_PATCH_YOUTUBE_MUSIC=yt-music-is-shit
YOUTUBE_VERSION=67.68.69
YOUTUBE_MUSIC_VERSION=latest
TWITTER_VERSION=0.2.2
REDDIT_VERSION=latest
TIKTOK_VERSION=latest
WARNWETTER_VERSION=latest
```
</details>
2. Go to actions tab. Select `Build Revanced APK`.Click on `Run Workflow`.
## Note ## 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. If you want to a specific version . Add the version in `environment` like
```dotenv ```dotenv
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) . 2. If you want to a `latest` version, whatever latest is available(including beta) .
Add `latest` in `environment` file like Add `latest` in `environment` file like
```dotenv ```dotenv
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 3. By default, it will build all build app supported by revanced team. If you don't
want to waste time and build only few apps. Add following(the apps you want to want to waste time and build only few apps. Add following(the apps you want to
build) `environment`. build) `environment`.
```dotenv ```dotenv
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 4. 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 file in `environment`
```dotenv ```dotenv
KEYSTORE_FILE_NAME=revanced.keystore KEYSTORE_FILE_NAME=revanced.keystore
``` ```
5. If you want to exclude any patch. Set comma seperated environment variable like 5. If you want to exclude any patch. Set comma seperated environment variable like
```dotenv ```dotenv
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
``` ```
Thanks to [@aliharslan0](https://github.com/aliharslan0/pyrevanced) for his work. Thanks to [@aliharslan0](https://github.com/aliharslan0/pyrevanced) for his work.