Download APKs from Google Play Store using anonymous authentication. Downloads base APKs, split APKs (App Bundles), OBB expansion files, and Play Asset Delivery packs — all by default.

v2.0 — Complete Rewrite. Ground-up rewrite with a new CLI, pure-Python protobuf decoding (no gpapi dependency), and automatic token management. Looking for v1.x? See the master branch.

• Anonymous authentication via Aurora Store's token dispenser (no Google account needed)
• 23 device profiles with automatic rotation for reliable token acquisition
• Downloads base APK, split APKs, OBB files, and asset packs in one go
• Streaming gzip decompression for Play Asset Delivery packs
• Beautiful terminal UI with real-time download progress bars
• Architecture support: ARM64 (modern phones) and ARMv7 (older phones)
• Custom token dispenser URL support
• Search and browse app details from the command line

Requirements: Python 3.9+

pip install gplaydl

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

# 1. Get an auth token (automatic, anonymous)
gplaydl auth

# 2. Download an app (base APK + splits + OBB/asset packs)
gplaydl download com.whatsapp

gplaydl auth                          # Default (arm64)
gplaydl auth --arch armv7             # Token for older ARM devices
gplaydl auth -d https://my-server/api # Use a custom dispenser
gplaydl auth --clear                  # Remove all cached tokens

Tokens are cached at ~/.config/gplaydl/auth-{arch}.json and reused automatically by other commands.

By default, download fetches the base APK, all split APKs, and any additional files (OBB expansion files, Play Asset Delivery packs).

gplaydl download com.whatsapp                  # Everything (base + splits + extras)
gplaydl download com.whatsapp -o ./apks        # Custom output directory
gplaydl download com.whatsapp -a armv7          # ARMv7 build
gplaydl download com.whatsapp -v 231205015      # Specific version code
gplaydl download com.whatsapp --no-splits       # Skip split APKs
gplaydl download com.whatsapp --no-extras       # Skip OBB / asset packs
gplaydl download com.whatsapp -d https://...    # Use custom dispenser

Output files:

Split APKs can be installed to a device with:

adb install-multiple *.apk

gplaydl info com.whatsapp

Displays app name, version, developer, rating, download count, and Play Store URL.

gplaydl search "whatsapp"
gplaydl search "file manager" --limit 5

gplaydl list-splits com.whatsapp

Shows all split APK names (config splits, language splits, etc.) without downloading.

python -m gplaydl auth
python -m gplaydl download com.whatsapp

1. Authentication — Gets an anonymous token from Aurora Store's dispenser, rotating through device profiles for reliability
2. Details — Fetches app metadata (version, size, splits) via Google Play's protobuf API
3. Purchase — "Purchases" the free app to get download authorization
4. Delivery — Gets download URLs for the base APK, split APKs, OBB files, and asset packs
5. Download — Streams all files in parallel from Google Play CDN with progress tracking

The tool uses Aurora Store's public token dispenser by default (https://auroraoss.com/api/auth). This service provides anonymous Google Play authentication tokens — no personal Google account required.

You can point to a custom/self-hosted dispenser with the --dispenser / -d flag on any command:

gplaydl auth -d https://my-dispenser.example.com/api/auth
gplaydl download com.whatsapp -d https://my-dispenser.example.com/api/auth

The tool includes 23 device profiles from Aurora Store, used to authenticate with Google Play's token dispenser. Profiles are rotated automatically during token acquisition to maximize compatibility.

Profiles are stored as .properties files in the gplaydl/profiles/ directory.

MIT — see LICENSE for details.