gplay-cli

A fast, standalone command-line tool and interactive wizard written in Rust to search, download, and install Android applications directly from the Google Play Store—without needing a personal Google account.

---

✨ Features

• ⚡ Zero-Login Required: Anonymous session negotiation via public Aurora token dispenser with silent auto-refresh.
• 🔒 100% Authentic Signatures: Downloads official Google Play binaries with original cryptographic developer signatures.
• 📜 Smart Version Resolution: Download by version name (e.g. 8.22.2), version code (e.g. 173301), or latest with automatic version suggestion fallback.
• 📦 Standard .apks Bundle Export: Automatically packages Split APKs into .apks bundles saved directly in your current directory.
• 📲 Optional One-Step ADB Installation: Seamlessly stream and install APKs or split bundles to connected devices with gplay-cli install.
• 🎨 Interactive TUI: Easy-to-use terminal wizard for quick searching, browsing versions, and downloading.

---

🚀 Installation

1. Pre-built Binaries (No Rust Required)

Download the ready-to-run binary for your platform from the GitHub Releases page:

Platform	Architecture	Binary Archive
🍏 macOS	Apple Silicon (M1/M2/M3/M4)	gplay-cli-aarch64-apple-darwin.tar.gz
🍏 macOS	Intel (x86_64)	gplay-cli-x86_64-apple-darwin.tar.gz
🐧 Linux	x86_64 (musl static / glibc)	gplay-cli-x86_64-unknown-linux-musl.tar.gz
🐧 Linux	ARM64 / AArch64	gplay-cli-aarch64-unknown-linux-musl.tar.gz
🪟 Windows	x86_64 (64-bit)	gplay-cli-x86_64-pc-windows-msvc.zip

# Example for Linux/macOS:
tar -xzf gplay-cli-*.tar.gz
sudo mv gplay-cli /usr/local/bin/

---

2. Via Cargo (Rust Package Manager)

cargo install gplay-cli

---

3. From Source

Ensure you have Rust & Cargo installed:

# Clone the repository
git clone https://github.com/vichhka-git/gplay-cli.git
cd gplay-cli

# Build optimized release binary
cargo build --release

# Install binary to Cargo bin path (~/.cargo/bin)
cargo install --path .

Note on ADB: ADB is completely optional. It is only required if you use direct device installation (gplay-cli install). Searching, version lookup, and downloading work standalone without ADB or Android SDK.

---

🛠️ Usage

Tip: You can use either gplay-cli or gplay as your terminal command.

Interactive Wizard (Default)

Launch the interactive prompt by running without arguments:

gplay-cli

---

Command Line Interface

🔍 Search Apps

gplay-cli search telegram
gplay-cli search "signal private messenger" --limit 10

ℹ️ App Details

gplay-cli info org.thoughtcrime.securesms

📜 List Historical Versions

gplay-cli versions org.thoughtcrime.securesms

⬇️ Download App

Files are automatically saved to your current working directory (or custom path with -o):

# Download latest version (saves to ./<pkg>_<ver>.apk or .apks)
gplay-cli download org.thoughtcrime.securesms

# Download specific version by Version Name
gplay-cli download org.thoughtcrime.securesms 8.22.2

# Download specific version by Version Code
gplay-cli download org.thoughtcrime.securesms 173301

# Download to a specific output folder
gplay-cli download org.thoughtcrime.securesms 8.22.2 -o ./my_folder

📲 Direct Install via ADB

Download from Google Play or pass a local file to install directly onto a connected Android device:

# 1. Download from Google Play and install in one step:
gplay-cli install org.thoughtcrime.securesms
gplay-cli install org.thoughtcrime.securesms 8.22.2

# 2. Install a local .apks bundle:
gplay-cli install ./app.apks

# 3. Install a local folder containing split APKs:
gplay-cli install ./app_splits/

# 4. Install a local standalone .apk:
gplay-cli install ./app.apk

🔑 Authentication & Session Management

gplay-cli supports both Zero-Setup Anonymous Mode and Custom Google Account Login:

1. Anonymous Mode (Default — Zero Setup)

By default, gplay-cli automatically negotiates an anonymous session using Aurora token dispensers (auroraoss.com), registers a simulated Android device profile (Pixel 7a), performs check-in, and caches the session locally in ~/.config/gplay-cli/session.json.

gplay-cli auth status     # View active session type (Anonymous vs Custom)
gplay-cli auth refresh    # Acquire a fresh anonymous session
gplay-cli auth logout     # Clear cached credentials

2. Custom Google Account Login

To download apps linked to your personal Google account (e.g. your purchased apps, beta tracks, or account-specific licensing), simply use the native login command:

# Interactive sign-in (guides you to sign in via browser):
gplay-cli auth login

# Or pass credentials directly:
gplay-cli auth login --email "your_email@gmail.com" --token "oauth2_4/..."

To switch back to anonymous mode at any time, run gplay-cli auth logout or gplay-cli auth refresh.

Project References

gplay-cli is based on these projects:

• AuroraStore
• YalpStore
• AppCrawler
• Raccoon
• SAI

---

📄 License

This project is licensed under the MIT License.