Skip to main content

gplaydl

Download APKs from Google Play right from your terminal. One command gets you the base APK, split APKs (App Bundles), OBB expansion files and Play Asset Delivery packs.

gplaydl downloads through a Google account you add yourself in the Authenticator app. Your account stays private to you, and setup takes about two minutes.

Prefer a browser? Use gplaydl web, or view its source code.

Important: This project uses unofficial Google Play access. Google may flag, lock, or restrict accounts used with it. Please use a separate account and continue at your own risk.

  • Base APK, splits, OBB files and asset packs downloaded together by default
  • arm64, armv7, x86, x86_64, Android TV and Wear OS builds, several in one command
  • Signs in with your own account, kept private to you and never shared
  • Device profiles rotated automatically, both for authentication and for old versions Google only serves to certain devices
  • Compressed transfers when Google Play offers them (often 30-40% smaller)
  • Every APK verified against the SHA-256 Google Play declares for it
  • Language splits on demand, and re-runs fetch only what is missing
  • Pure-Python protobuf decoding
  • Live progress bars, plus search, info and list-splits for browsing
AndroidPot No Google account? Try AndroidPot. Paste a Google Play link or package name into the AndroidPot APK downloader and get the APK, no Google account required. Split APKs and OBB files come packed into a single XAPK. On your phone, the AndroidPot app finds and installs apps in one tap.

Installation

Requires Python 3.9 or newer.

pip install gplaydl

Or from source:

git clone https://github.com/rehmatworks/gplaydl.git && cd gplaydl
pip install .

First-time setup

You will need any Android phone for a couple of minutes, and a spare Google account to add.

No spare account? The AndroidPot APK downloader gets APKs from Google Play without any Google account.

  1. Install the gplaydl Authenticator app (source) on the phone. It is not on Google Play, so Android will ask you to allow the install.
  2. Sign in with a spare Google account. Prefer a throwaway over your main one: Google sometimes restricts accounts it sees on unofficial clients. The account stays private to you and is never shared with anyone.
  3. Open Link gplaydl in the app, then run this on your computer and type in the code it shows:
gplaydl link

Done. Every download now goes through your own account:

gplaydl download com.whatsapp

Your Google password and 2FA codes never leave the phone; the app uploads only the resulting Play token. You can remove an account in the app whenever you like, and if you skip gplaydl link, the first command that needs it will walk you through the same steps.

Quick start

gplaydl link                    # once, with the code from the app
gplaydl download com.whatsapp   # base APK + splits + OBB/asset packs

Commands

Every command takes -d/--dispenser to pick a dispenser and --arch for the device architecture.

Pairs this machine with the dispenser. Run it once, or again to re-link.

gplaydl link                              # asks for the code interactively
gplaydl link --code ABCD-EFGH             # or pass it directly
gplaydl link -d https://your.dispenser    # link to a self-hosted dispenser

The key lands in ~/.config/gplaydl/config.json. For containers and CI, set GPLAYDL_API_KEY instead of linking interactively.

If you added more than one account in the app, pass --email you@gmail.com on auth or download to use a specific one. Without it, gplaydl rotates through the accounts you added.

auth

Gets a Play token and caches it. You rarely need to run this yourself; the other commands fetch and refresh tokens on their own.

gplaydl auth                              # default (arm64)
gplaydl auth --arch armv7                 # older 32-bit devices
gplaydl auth --arch x86_64                # emulators / desktop
gplaydl auth --clear                      # forget all cached tokens

Tokens live in ~/.config/gplaydl/auth-{arch}.json and refresh automatically before they expire.

download

Fetches the base APK, every split APK, and any extra files unless you opt out.

gplaydl download com.whatsapp                # everything
gplaydl download com.whatsapp -o ./apks      # custom output directory
gplaydl download com.whatsapp -a armv7       # ARMv7 build
gplaydl download com.whatsapp -a arm64,armv7 # several architectures at once
gplaydl download org.videolan.vlc -a x86_64  # emulator / desktop build
gplaydl download com.google.android.katniss -a tv  # Android TV build
gplaydl download com.spotify.music -a wear   # Wear OS (watch) build
gplaydl download com.whatsapp -v 231205015   # specific version code
gplaydl download com.whatsapp -l de,fr,zh-CN # extra language splits
gplaydl download com.whatsapp --no-splits    # skip split APKs
gplaydl download com.whatsapp --no-extras    # skip OBB / asset packs
gplaydl download com.whatsapp --dm           # also fetch the .dm metadata

Downloads are verified: the base APK and every split are hashed while they stream in and checked against the SHA-256 that Google Play declares in the delivery response, so a truncated or corrupted file fails loudly instead of failing later at install time.

Re-runs are incremental. A file that already exists and matches its declared hash is skipped, so running the same command again with an extra architecture (-a arm64,armv7) or more languages (-l de,fr) downloads only the missing splits into the same directory. A corrupted file is noticed and fetched again.

--dm additionally fetches the DEX metadata file ({package}-{vc}.dm, a baseline profile plus vdex) that the Play Store installs alongside the base APK to speed up first launch. It is optional; append it to adb install-multiple after the APKs if you want it.

Old version codes are served by Google only to devices it considers compatible: 32-bit-only APKs are refused for 64-bit-only profiles, and Android 14+ profiles are not served APKs targeting very old SDKs. When that happens, gplaydl retries automatically with low-SDK multi-ABI device profiles until Google agrees to deliver.

Apps that are invisible to phone profiles altogether (Android TV exclusives like com.google.android.katniss, Wear OS-only apps, or apps limited to one ABI family) are found the same way: gplaydl rotates through one device of each kind, starting with TV, then Wear OS, then each ABI family. Pass -a tv or -a wear to skip straight to a TV or watch profile, or run gplaydl auth --arch tv if you just want a TV token (~/.config/gplaydl/auth-tv.json).

Apps that ship for both phones and watches usually publish a separate Wear OS build under the same package name. A plain download gets the phone build; -a wear gets the watch one.

Type Naming Example
Base APK {package}-{vc}.apk com.whatsapp-231205015.apk
Split APK {package}-{vc}-{split}.apk com.whatsapp-231205015-config.arm64_v8a.apk
OBB (main/patch) {type}.{vc}.{package}.obb main.20925.com.tencent.ig.obb
Asset pack {package}-{vc}-asset.apk com.tencent.ig-20925-asset.apk

Install a split build on a device by naming the app's own files, e.g. adb install-multiple com.whatsapp-231205015*.apk. (Avoid a bare *.apk when other APKs sit in the same directory: adb refuses sessions that mix packages or contain the same split twice.)

Want a single APK instead of splits? Google Play has no universal APK for App Bundle apps. Every client, including the Play Store itself, receives the base plus config splits and installs them as one session. The base APK alone will not run (its native libraries live in the config.<abi> split). If you truly need one file, merge the splits with a tool like APKEditor (APKEditor m -i ./apks); note the merged APK must be re-signed, so it will not receive updates on top of the Play-signed install.

info, search and list-splits

gplaydl info com.whatsapp                 # version, developer, rating, downloads
gplaydl search "file manager" --limit 5   # find apps by name
gplaydl list-splits com.whatsapp          # see splits without downloading

Multiple accounts and purchased apps

You can add several accounts in the app. By default gplaydl rotates through them; pass --email to pick one, which is also how you download apps tied to a specific account:

gplaydl download com.example.paid --email you@gmail.com

A word of caution before adding an account you care about: Google can rate-limit, lock, or restrict accounts it sees on unofficial clients. It is uncommon, but it happens, which is why a throwaway account is the safer choice.

Self-hosting

The dispenser is open source and runs anywhere Go and Postgres do. Host your own for a team or just for yourself:

  1. Follow the dispenser deployment guide.
  2. In the Authenticator app, point Settings → Server at your instance and add accounts.
  3. Link gplaydl against it: gplaydl link -d https://your.dispenser

Architecture support

Flag ABI Devices
arm64 (default) arm64-v8a Modern phones (2017+)
armv7 armeabi-v7a Older 32-bit phones
x86_64 x86_64 Emulators, Chromebooks, desktop
x86 x86 Older 32-bit emulators
tv armeabi-v7a Android TV / Google TV devices
wear armeabi-v7a Wear OS watches

Pass several at once to download with a comma: -a arm64,armv7. The base APK is shared where possible and per-architecture splits (or separate builds, for apps that publish one APK per ABI) land next to each other.

How it works

  1. Authenticate. The dispenser mints a Play token from one of your own accounts and hands it back, trying device profiles in turn until one is accepted.
  2. Look up. App metadata (version, size, split list) comes from Google Play's protobuf API.
  3. Purchase. Free apps are "purchased" to authorise the download; the delivery token Google returns is passed along to the delivery endpoint.
  4. Download. Base APK, splits, OBB files and asset packs stream in parallel from Google's CDN, using gzip-compressed transfers when offered.

Upgrading from 3.x

gplaydl 4 drops the shared community pool: downloads now go through a Google account you add yourself, kept private to you. Add an account in the Authenticator app and run gplaydl link once after upgrading. (Older 2.x releases borrowed anonymous tokens from Aurora Store; that path is gone.)

License

MIT. See LICENSE.

Metadata

Release files for gplaydl 4.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gplaydl 4.4.0
File Size Uploaded Provenance Actions
gplaydl-4.4.0.tar.gz 74.7 kB With provenance Details for gplaydl-4.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gplaydl 4.4.0
File Interpreter ABI Platform Actions
gplaydl-4.4.0-py3-none-any.whl Python 3 none any Details for gplaydl-4.4.0-py3-none-any.whl

Total release size: 217.3 kB

Release files / gplaydl-4.4.0.tar.gz

Download URL gplaydl-4.4.0.tar.gz
Size 74.7 kB
Tags Source
SHA-256 checksum
How to use checksums
6a77291da6837d4f71aa38966af0693833a01b45d12f7195f8524bb3d1f4fa1c
BLAKE2b-256 checksum
How to use checksums
419f65b1f9e8b3f53758257fcd232d747cb9b9b102578cd2c117269587cf40e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / gplaydl-4.4.0-py3-none-any.whl

Download URL gplaydl-4.4.0-py3-none-any.whl
Size 142.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ea830ba2d4f8a323cd98cacd521d7a2f2d92ab9faf31246632e6c613ab69063a
BLAKE2b-256 checksum
How to use checksums
43f6e0829dc608235840d2d017cf80170e653087d3e390e74f2688fa55bfa773
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for gplaydl 4.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for gplaydl-4.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page