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

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

You can get pre-built apks here

You can use any of the following methods to build.

• 🚀In GitHub (Recommended)

  1. Fork the project.
     
     

  2. 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
       

  3. 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.
       

  4. 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

  1. Install Docker(Skip if already installed)

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

  2. Grant Permissions with(Skip if already there)

      sudo chmod 777 /var/run/docker.sock

  3. 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

  4. Clone the repo

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

  5. cd to the cloned repo

     cd docker-py-revanced

  6. Update .env file if you want some customization(See notes)
  7. 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 below envs(See notes) with -e flag or use --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
     

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

1. 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

2. Remember to download the Microg. Otherwise, you will not be able to open YouTube.

3. 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

4. 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

5. 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

6. 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

7. 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

8. 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

9. 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
      

10. 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.

11. You can scan your build apks files with VirusTotal. For that, Add VT_API_KEY in GitHub secrets.

12. 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.

13. Sample Envs
    

Thanks to @aliharslan0 for his work.