🤓Docker-Py-ReVanced

A little python script that will help you in building Revanced and Revanced-Extended apps.

Note - If you are a root user and want magisk module (Extended). Get them here

This is just a builder for revanced and not a revanced support. Please be understanding and refrain from asking about revanced features/bugs. Discuss those on proper relevant forums(on Revanced GitHub , Discord)

Note - I prefer Revanced Extended more (for YouTube & YouTube Music) hence the YouTube and YouTube Music builds in this repo are from Revanced Extended.

Pre-Built APKs

You can get pre-built apks here

Build Yourself

You can use any of the following methods to build.

🚀In GitHub (Recommended)
1. Click Star to support the project.
2. Fork the project.
3. Add ENVS (optional) secret to the repo. Required only if you want to cook specific apps/versions.
  🚶Detailed step by step guide
  - Go to the repo settings and then to actions->secret
  - Add Repository secret
4. Go to actions tab. Select Build & Release.Click on Run Workflow.
  🚶Detailed step by step guide
  - Go to actions tab
  - Check the status of build, It should look green.
5. If the building process is successful, you’ll get your APKs in the

🐳With Docker Compose Windows/Mac users simply install Docker Desktop. If using Linux see below

Install Docker(Skip if already installed)

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Grant Permissions with(Skip if already there)
```
 sudo chmod 777 /var/run/docker.sock
```

Install Docker compose(Skip if already installed or using Docker Desktop)

curl -L "https://github.com/docker/compose/releases/download/v2.10.2/docker-compose-$(uname -s)-$(uname -m)" \
-o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Clone the repo

git clone https://github.com/nikhilbadyal/docker-py-revanced

cd to the cloned repo
```
cd docker-py-revanced
```
Update .env file if you want some customization(See notes)
Run script with
```
docker-compose up
```

🐳With Docker
1. Install Docker(Skip if already installed)
```
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
```
2. Run script with
```
docker run -v "$(pwd)"/apks:/app/apks/  nikhilbadyal/docker-py-revanced
```
  You can pass the below environment variables (See notes) with the -e flag or use the --env-file flag.
🫠Without Docker
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
```

Note

(Pay attention to 3,4)
By default, script build the version as recommended by Revanced team.

Supported values for REVANCED_APPS_NAME are :
1. youtube
2. youtube_music
3. twitter
4. reddit
5. tiktok
6. warnwetter
7. spotify
8. nyx-music-player
9. icon_pack_studio
10. ticktick
11. twitch
12. hex-editor
13. windy
14. my-expenses
15. backdrops
16. expensemanager
17. tasker
18. irplus
19. vsco
20. meme-generator-free
21. nova_launcher
22. netguard
23. instagram
24. inshorts
25. facebook
26. grecorder
27. trakt
28. candyvpn
29. sonyheadphone
30. androidtwelvewidgets
31. yuka
32. relay
33. boost
34. rif
35. sync
36. infinity
37. slide
38. bacon
39. microg
Please verify the source of original APKs yourself with links provided. I'm not responsible for any damaged caused. If you know any better/safe source to download clean. Please raise a PR.
Remember to download the Microg. Otherwise, you will not be able to open YouTube.
By default, it will build only youtube. To build other apps supported by revanced team. Add the apps you want to build in .env file or in ENVS in GitHub secrets in the format
```
PATCH_APPS=<REVANCED_APPS_NAME>
```
Example:
```
PATCH_APPS=youtube,twitter,reddit
```
If you want to exclude any patch. Set comma separated patch in .env file or in ENVS in GitHub secrets (Recommended) in 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_MUSIC=yt-music-is-shit
```
If you are using Revanced Extended. Add _EXTENDED in exclude options. Example:
```
 EXCLUDE_PATCH_YOUTUBE_EXTENDED=custom-branding-red,custom-branding-blue,materialyou
 EXCLUDE_PATCH_YOUTUBE_MUSIC_EXTENDED=custom-branding-music
```
All the patches for an app are included by default..

If you want to apply a universal patch. You can include it manually. See below for more information.
If you want to include any universal patch. Set comma separated patch in .env file or in ENVS in GitHub secrets (Recommended) in the format
```
INCLUDE_PATCH_<REVANCED_APPS_NAME>=<PATCH_TO_EXCLUDE-1,PATCH_TO_EXCLUDE-2>
```
Example:
```
 INCLUDE_PATCH_YOUTUBE=remove-screenshot-restriction
```
If you are using Revanced Extended. Add _EXTENDED in exclude options. Example:
```
 INCLUDE_PATCH_YOUTUBE_EXTENDED=remove-screenshot-restriction
```
Remember - Revanced patches are provided space separated, make sure you type those - separated here. It means a patch named Hey There will be entered as hey-there in the above example.

If you want to build a specific version . Add version in .env file or in ENVS in GitHub secrets (Recommended) in the format

<APPNAME>_VERSION=<VERSION>

Example:

YOUTUBE_VERSION=17.31.36
YOUTUBE_MUSIC_VERSION=X.X.X
TWITTER_VERSION=X.X.X
REDDIT_VERSION=X.X.X
TIKTOK_VERSION=X.X.X
WARNWETTER_VERSION=X.X.X

If you want to build latest version, whatever latest is available(including beta) . Add latest in .env file or in ENVS in GitHub secrets (Recommended) in the format

<APPNAME>_VERSION=latest

Example:

YOUTUBE_VERSION=latest
YOUTUBE_MUSIC_VERSION=latest
TWITTER_VERSION=latest
REDDIT_VERSION=latest
TIKTOK_VERSION=latest
WARNWETTER_VERSION=latest

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 keystore-file in .env file or in ENVS in GitHub secrets (Recommended) in the format
```
 KEYSTORE_FILE_NAME=revanced.keystore
```
If you want to use Revanced-Extended for YouTube and YouTube Music. Add the following adding in .env file or in ENVS in GitHub secrets (Recommended) in the format
```
 BUILD_EXTENDED=True
```
or disable it with (default)
```
 BUILD_EXTENDED=False
```
For Telegram Upload.
1. Set up a telegram channel, send a message to it and forward the message to this telegram bot
2. Copy id and save it to TELEGRAM_CHAT_ID
3. TELEGRAM_BOT_TOKEN - Telegram provides BOT_TOKEN. It works as sender. Open bot and create one copy api key
4. TELEGRAM_API_ID - Telegram API_ID is provided by telegram here
5. TELEGRAM_API_HASH - Telegram API_HASH is provided by telegram here
6. After Everything done successfully the actions secrets of the repository will look something like
You can build only for a particular arch in order to get smaller apk files.This can be done with by adding comma separated ARCHS_TO_BUILD in ENVS in GitHub secrets (Recommended) in the format.
```
 ARCHS_TO_BUILD=arm64-v8a,armeabi-v7a
```
Possible values for ARCHS_TO_BUILD are: armeabi-v7a,x86,x86_64,arm64-v8a Make sure you are using revanced-extended as revanced doesn't support this.
You can scan your built apks files with VirusTotal. For that, Add VT_API_KEY in GitHub secrets.
Configuration defined in ENVS in GitHub secrets will override the configuration in .env file. You can use this fact to define your normal configurations in .env file and sometimes if you want to build something different just once. Add it in GitHub secrets.
Or you can ignore what I said above and always use GitHub secrets.
If APKMirror or other apk source is blocked in your region or script somehow is unable to download from apkmirror. You can download apk manually from any source. Place them in /apks directory and provide environment variable in .env file or in ENVS in GitHub secrets(Recommended) in the format.
```
 EXISTING_DOWNLOADED_APKS=<Comma,Seperate,App,Name>
```
Example:
```
 EXISTING_DOWNLOADED_APKS=youtube,youtube_music
```
If you add above. Script will not download the Youtube & youtube musicapk from internet and expects an apk in /apks folder.

Name of the downloaded apk must match with the available app choices found here.
If you run script again & again. You might hit GitHub API limit. In that case you can provide your Personal GitHub Access Token in .env file or in ENVS in GitHub secrets (Recommended) in the format -
```
 PERSONAL_ACCESS_TOKEN=<PAT>
```
Sample Envs
Make your Action has write access. If not click here. In the bottom give read and write access to Actions.
If you want to patch reddit apps using your own Client ID. You can provide your Client ID as secret REDDIT_CLIENT_ID in GitHub secrets.

Thanks to @aliharslan0 for his work.

nikhilbadyal/docker-py-revanced

nikhilbadyal

Reviews

Repository Details

🤓Docker-Py-ReVanced

Pre-Built APKs

Build Yourself

Note

More Repositories