mirror of
https://github.com/sotam0316/docker-py-revanced.git
synced 2026-04-25 03:48:37 +09:00
📝 Updated Docs
This commit is contained in:
@@ -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
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
- **`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
|
||||||
```
|
```
|
||||||
|
|||||||
Reference in New Issue
Block a user