gplay-cli

KO | EN

gitlite — search

#macos #php #sql #monitoring #nodejs #json #mcp #openai #animation #linux

(★ 9)

gplay-cli: Fast, standalone Google Play APK downloader & installer in Rust (Zero-login required)

파일 탐색기

ZIP 다운로드

- - ci.yml
  - release.yml
- adb.rs
- api.rs
- apks.rs
- auth.rs
- cli.rs
- device.rs
- downloader.rs
- interactive.rs
- main.rs
- models.rs
- proto.rs
.gitignore
Cargo.toml
LICENSE
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

# 프로젝트 배지

Crates.io 바로가기
Rust 바로가기
License: MIT 바로가기
Platform 바로가기

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

</div>

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**](https://github.com/vichhka-git/gplay-cli/releases/latest) page:

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

---

### 2. Via Cargo (Rust Package Manager)

```bash
cargo install gplay-cli
```

---

### 3. From Source

Ensure you have [Rust & Cargo](https://rustup.rs/) installed:

```bash
# 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:

```bash
gplay-cli
```

---

### Command Line Interface

#### 🔍 Search Apps
```bash
gplay-cli search telegram
gplay-cli search "signal private messenger" --limit 10
```

#### ℹ️ App Details
```bash
gplay-cli info org.thoughtcrime.securesms
```

#### 📜 List Historical Versions
```bash
gplay-cli versions org.thoughtcrime.securesms
```

#### ⬇️ Download App
Files are automatically saved to your current working directory (or custom path with `-o`):
```bash
# 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:
```bash
# 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`.

```bash
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:

```bash
# 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](https://github.com/whyorean/AuroraStore)
- [YalpStore](https://github.com/yeriomin/YalpStore)
- [AppCrawler](https://github.com/Akdeniz/google-play-crawler)
- [Raccoon](https://github.com/onyxbits/raccoon4)
- [SAI](https://github.com/Aefyr/SAI)

---

## 📄 License

This project is licensed under the [MIT License](LICENSE).

gplay-cli

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

# 프로젝트 배지

Was this content helpful?

Recent Feedback

gplay-cli

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

# 프로젝트 배지

Was this content helpful?

Recent Feedback

Download README