PlayDL is a Telegram bot that takes a Google Play link, downloads the app, merges split APKs when needed, and sends a regular installable APK back to the user.

The bot is built with Python 3.13 and aiogram 3.28.x

Persian guide: README-Fa.md

• Extracts the package name from the link.
• Downloads the app with one of the supported downloader backends.
• Converts .apks or split APK folders into one installable .apk.
• Delivers the APK through one of three channels:
  • Telegram — direct upload (needs local Bot API server for files > 50 MB).
  • NixFile — Selenium-driven hosted link on panel.nixfile.com.
  • Rubika — sent to any @username from the bot-owned Rubika account, with a parallel-chunk uploader and zip wrap (Rubika rejects .apk).
• Saves user/job status in MongoDB.

• Python 3.13
• MongoDB
• Java 17+
• Telegram Bot API local server
• One Google Play downloader backend:
  • Recommended: alltechdev/gplay-apk-downloader
  • Alternative: gplaydl
  • Alternative: apkeep
• APKEditor.jar for merging split APKs

PlayDL can install missing helper tools on startup when AUTO_INSTALL_TOOLS=true. It can clone alltechdev/gplay-apk-downloader, install gplaydl with pip, install apkeep with Cargo if Rust is present, and download the latest APKEditor jar. It does not install OS services/packages such as Java, MongoDB, Telegram Bot API server, git, or Rust.

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
cp .env.example .env
python Main.py

On Windows PowerShell:

py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env

Ubuntu/Debian:

sudo apt update
sudo apt install -y openjdk-17-jre-headless
java -version

Full JDK, if you need it:

sudo apt install -y openjdk-17-jdk

CentOS/RHEL/Rocky:

sudo dnf install -y java-17-openjdk
java -version

Download the latest APKEditor-*.jar from:

https://github.com/REAndroid/APKEditor/releases

Place it here:

tools/APKEditor.jar

Or point to it in .env:

APKEDITOR_JAR=/opt/apkeditor/APKEditor.jar

Edit .env:

BOT_TOKEN=123456:CHANGE_ME

TELEGRAM_API_BASE_URL=http://127.0.0.1:8081
TELEGRAM_API_IS_LOCAL=true

MONGODB_URI=mongodb://localhost:27017
MONGODB_DB_NAME=playdl

AUTO_INSTALL_TOOLS=true
TOOLS_DIR=tools
DOWNLOAD_DIR=storage/downloads
MAX_PARALLEL_JOBS=2

This backend is closest to what the bot needs. It downloads Google Play files and can merge/sign split APKs.

PLAY_DOWNLOADER_BACKEND=alltech-gplay
ALLTECH_GPLAY_PATH=tools/gplay-apk-downloader/gplay
ALLTECH_AUTO_AUTH=true
ALLTECH_AUTH_FILE=~/.gplay-auth.json
PLAY_ARCH=arm64
MERGE_SPLITS=true

With AUTO_INSTALL_TOOLS=true, the bot clones this repo into tools/gplay-apk-downloader if it is missing. With ALLTECH_AUTO_AUTH=true, it also runs gplay auth once if ~/.gplay-auth.json is missing.

gplaydl is installed by requirements.txt. It can download base and split APK files. PlayDL then merges them with APKEditor.

PLAY_DOWNLOADER_BACKEND=gplaydl
PLAY_ARCH=arm64
APKEDITOR_JAR=tools/APKEditor.jar

With auto-install enabled, the bot runs python -m pip install gplaydl>=2.1,<3 if the gplaydl command is missing.

Good if you already use apkeep and have Google Play credentials or an AAS token.

PLAY_DOWNLOADER_BACKEND=apkeep
APKEEP_SOURCE=google-play
APKEEP_EMAIL=you@example.com
APKEEP_TOKEN=your_aas_token

With auto-install enabled, the bot runs cargo install apkeep if apkeep is missing and Cargo is available.

Use this when you have your own downloader script.

PLAY_DOWNLOADER_BACKEND=custom
PLAY_DOWNLOADER_CMD=apkeep -a "{package}" "{output_dir}"
APKS_TO_APK_CMD=java -jar tools/APKEditor.jar m -i "{input}" -o "{output}"

Available template variables:

• {url}: full Google Play URL
• {package}: package name, for example org.telegram.messenger
• {output_dir}: job download folder
• {arch}: configured architecture, for example arm64

Go to nixfile.com, create an account and put the username & password in your .env file in NIXFILE_USERNAME and NIXFILE_PASS fields. The bot logs in on the first run and reuses the saved session afterwards.

The Rubika channel sends the APK from a bot-owned Rubika user account to any @username. Auth is via a pre-generated rubpy session file.

python session_rubika.py

Follow the prompts (phone number, OTP). This creates storage/playdl_rubika.rp. If the file is missing the Rubika button stays in the menu but uploads return "Rubika غیرفعال است".

Rubika rejects .apk extensions on user-account uploads, so the bot zips the file as NitoNumber-1.zip before sending. To avoid timeouts on large APKs, rubpy's sequential 1 MB chunk uploader is monkey-patched on startup to upload 8 chunks in parallel — see _parallel_upload_file in Services/rubika.py. Adjust RUBIKA_UPLOAD_CONCURRENCY in the same file if the Rubika DC rate-limits.

Tunables in .env:

RUBIKA_SESSION_NAME=playdl_rubika
RUBIKA_SESSION_DIR=storage
RUBIKA_MAX_FILE_MB=500
RUBIKA_UPLOAD_TIMEOUT=900

python Main.py

If the downloader returns:

• one .apk: the bot sends it as-is
• one .apks: APKEditor merges it into .apk
• multiple split .apk files in a folder: APKEditor merges the folder into merged.apk

If alltech-gplay is used with MERGE_SPLITS=true, it gets the first chance to merge. If split files still come out, PlayDL runs its own APKEditor merge step.

App/        bot startup and configuration
Handlers/   aiogram class-based handlers
DataBase/   MongoDB access layer
Services/   download, conversion, job helpers
Utils/      Persian texts and inline keyboards
tools/      optional local jars/scripts
storage/    downloads and runtime files