whatisgithub

What is playdl?

zethrise/playdl — explained in plain English

Analysis updated 2026-05-18

51PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

A Telegram bot that turns a Google Play Store link into a downloadable, installable APK file, merging split files automatically.

Mindmap

mindmap
  root((PlayDL))
    What it does
      Downloads Google Play apps
      Merges split APKs
      Sends APK via Telegram
    Tech stack
      Python 3.13
      aiogram
      MongoDB
      APKEditor
    Use cases
      Self hosted app downloader
      Telegram bot for APKs
      Persian speaking users
    Audience
      Self hosters
      Python developers
      Telegram bot operators
    Setup needs
      Java 17
      Local Telegram API server
      MongoDB instance
    Downloader backends
      gplay apk downloader
      gplaydl
      apkeep

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a personal Telegram bot that fetches apps from Google Play as installable APK files.

USE CASE 2

Automatically merge split APK bundles into a single installable file.

USE CASE 3

Offer app downloads to Persian speaking Telegram users through a local bot.

What is it built with?

PythonaiogramMongoDBJavaAPKEditor

How does it compare?

zethrise/playdlcortex-trading-systems/polymarket-copy-trading-bot-clob-aiqianchentao9/swingsr
Stars515151
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/53/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires MongoDB, Java 17, and your own locally hosted Telegram Bot API server.

No license information is stated in the README.

So what is it?

PlayDL is a Telegram bot that lets someone send it a Google Play Store link and get back an installable APK file. The bot pulls the package name from the link, downloads the app through one of a few supported downloader tools, merges any split APK files into a single regular APK, and uploads that file back to the user through Telegram. It is written in Python 3.13 using the aiogram library for Telegram, and it stores user and job status in MongoDB. To merge split APKs into one file it relies on a separate tool called APKEditor. For the actual downloading step, the project supports three different backends: a recommended tool called gplay-apk-downloader, a Python package called gplaydl, or a tool called apkeep, plus the option to plug in a fully custom download command. The bot can optionally install these helper tools itself on startup, but it does not install system level software such as Java, MongoDB, or the Telegram Bot API server, so those still need to be set up by hand. Running it requires several pieces in place: Python 3.13, MongoDB, Java 17 or newer, and a locally hosted Telegram Bot API server, since the public Telegram API will not work for this bot. Setup involves creating a virtual environment, installing dependencies, copying an example configuration file, and filling in values like the bot token and MongoDB connection string. There is also an optional upload step through a service called nixfile, which needs its own account credentials in the configuration file. The project includes a Persian language guide alongside the main English README, suggesting its primary user base speaks Persian. This is a self hosted, single purpose bot aimed at someone comfortable running a small Python service with a database, not a hosted or plug and play product.

Copy-paste prompts

Prompt 1
Walk me through setting up a local Telegram Bot API server so I can run PlayDL.
Prompt 2
Help me configure PlayDL's .env file with MongoDB and a gplay-apk-downloader backend.
Prompt 3
Explain how PlayDL merges split APK files using APKEditor.
Prompt 4
Help me troubleshoot PlayDL failing to download an app from a Google Play link.
Prompt 5
Show me how to switch PlayDL from the gplay-apk-downloader backend to apkeep.

Frequently asked questions

What is playdl?

A Telegram bot that turns a Google Play Store link into a downloadable, installable APK file, merging split files automatically.

What language is playdl written in?

Mainly Python. The stack also includes Python, aiogram, MongoDB.

What license does playdl use?

No license information is stated in the README.

How hard is playdl to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is playdl for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.