A feature-rich Terminal UI for downloading Android APKs from Google Play
Built for Termux · Powered by gplaydl
| Feature | Description |
|---|---|
| 🔍 Search & Download | Search Google Play and download any app by name |
| 📦 Split APK Merge | Automatically merges split APKs into a single installable APK using APKEditor |
| ✍️ APK Signing | Sign merged APKs with your keystore using apksigner (V1 + V2 + V3) |
| 📱 Device Profile | Replace the device profile used for downloads with any custom device |
| 📲 Auto Install | Automatically open the Android package installer after download |
| ⚙️ Full Configuration | Persistent config for all settings saved between sessions |
| ☕ Auto JDK Setup | Detects and installs openjdk-21 automatically if missing |
| 🔧 Auto jq Setup | Detects and installs jq automatically if missing |
| 📦 Auto gplaydl Setup | Installs and updates gplaydl via pip automatically |
| 🎨 Beautiful TUI | Fully coloured terminal interface with progress bars and status indicators |
pkg update && pkg upgrade
pkg install python git jq openjdk-21 -y
pip install gplaydl Place these JAR files in ~/gplay/bin/ before first run
| File | Purpose | Source |
|---|---|---|
| APKEditor.jar | Merges split APKs | Auto-downloaded from REAndroid/APKEditor |
| apksigner.jar | Signs Apks | already present and can be obtained from Build Tools |
git clone https://github.com/Graywizard888/GPlayDL-TUI.git
cd GPlayDL-TUI
chmod +x gplaydl_tui.py
python gplaydl_tui.py
~/gplay/
├── bin/
│ ├── APKEditor.jar ← auto-downloaded on first run
│ └── apksigner.jar ← place manually for signing support
├── .config/
│ └── gplaydl-tui/
│ └── config.json ← your saved settings
└── <package.name>/ ← temp download folder (auto-cleaned)
~/.config/gplaydl/
└── auth_arm64.json ← gplaydl authentication & device profile (gplaydl default fetched)
═══════════════════════════════════════════════════════════════
● SPLIT ● SKIP-EXTRAS ○ SIGN ○ INSTALL Arch: arm64 (default)
═══════════════════════════════════════════════════════════════
1 🔍 Search & Download
2 📱 Replace Device Profile
3 ⚙ Configure
4 🔄 Force Re-Authenticate
5 🚪 Exit
───────────────────────────────────────────────────────────────
Created by GrayWizard
───────────────────────────────────────────────────────────────
- Enter an app name to search Google Play
- Select the app number from the results table
- Review app info and confirm the download
- The script handles the rest automatically
Spoof the device identity used when communicating with Google Play. Useful for downloading APKs targeting specific hardware or Android versions.
Accepted JSON input formats:
// ── Format 1 – Full auth.json style ──────────────────────────
{
"deviceInfoProvider": {
"authUserAgentString": "GoogleAuth/1.4 (Pixel 9a BD4A.250405.003)",
"sdkVersion": "35",
"properties": {
"Build.MODEL": "Pixel 9a",
"Build.MANUFACTURER": "Google"
}
}
}
// ── Format 2 – Bare provider block ───────────────────────────
{
"authUserAgentString": "GoogleAuth/1.4 (Pixel 9a BD4A.250405.003)",
"sdkVersion": "35",
"properties": {
"Build.MODEL": "Pixel 9a",
"Build.MANUFACTURER": "Google"
}
}
// ── Format 3 – Partial snippet (no outer braces needed) ──────
"deviceInfoProvider": {
"authUserAgentString": "GoogleAuth/1.4 (Pixel 9a BD4A.250405.003)",
"sdkVersion": "35",
"properties": {
"Build.MODEL": "Pixel 9a"
}
}
"
⚠️ A backup of your original auth file is always saved as auth_arm64.json.bak before any changes are applied."
| Option | Settings | Description |
|---|---|---|
| 1 | Prefer Split APKs | ON = download splits and merge · OFF = --no-splits |
| 2 | Output Directory | Where to save the final APK (default: $HOME/GPlayDL-TUI) |
| 3 | Dispenser Link | Custom token dispenser URL |
| 4 | Skip Extras | ON = --skip-extras to skip OBB / patch files (recommended to off during downloading games) |
| 5 | Architecture | arm64 · armv7 · or let gplaydl decide (default) |
| 6 | Keystore | Path to .jks / .p12 / .pfx keystore file |
| 7 | Sign APKs | Toggle APK signing on / off (requires keystore) |
| 8 | Save & Return | save all changes to .config |
| 0 | Discard & Return | Abandon all unsaved changes |
| Scheme | Status |
|---|---|
| V1 – JAR Signing | ✅ Enabled ( Required for android 1.0+) |
| V2 – APK scheme Signing | ✅ Enabled ( Required for Android 7.0+) |
| V3 – APK scheme Signing | ✅ Enabled ( Required for Android 9.0+) |
You can make Google Play think you are downloading from a completely different device. Common use cases:
-
App is not available for your device
-
Download a specific ABI variant (arm64 vs armv7)
-
Target a specific SDK / Android version
-
Bypass some device compatibility restrictions
The script uses jq to surgically replace only the deviceInfoProvider block inside auth_arm64.json — all tokens, cookies and credentials remain untouched.
All settings are persisted at $HOME/gplay/.config/gplaydl-tui/config.json:
{
"prefer_split" : "on",
"output_dir" : "/sdcard/APKs",
"dispenser_link": "",
"skip_extras" : "on",
"arch" : "",
"keystore_path" : "/path/to/my.jks",
"keystore_alias": "mykey",
"keystore_pass" : "••••••••",
"key_pass" : "",
"keystore_type" : "JKS",
"sign_apk" : "on",
"auto_install" : "off"
}
If this tool helped you, consider giving it a ⭐ on GitHub