# matlink/gplaycli architecture

> Architecture diagram of the GitHub repository matlink/gplaycli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/matlink/gplaycli
- Repository: https://github.com/matlink/gplaycli

## Overview

GPlayCli is a command-line Google Play client for searching apps, downloading APKs and associated files, listing local APKs, and checking folders for updates. The main runtime is concentrated in `gplaycli/gplaycli.py`; `hooks.py` guards API operations and `util.py` supplies file, version-code, and progress helpers. The README documents the user-facing modes, while excerpts show token and download behavior. Some command dispatch and listing details are unsampled, so those relationships are documented rather than inferred as source-level calls.

Main entry points: [`gplaycli/gplaycli.py`](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py) (Play API client), [`gplaycli/hooks.py`](https://github.com/matlink/gplaycli/blob/master/gplaycli/hooks.py) (Connection guard), [`gplaycli/util.py`](https://github.com/matlink/gplaycli/blob/master/gplaycli/util.py) (File helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry"]
  node_cli["CLI commands<br/>[gplaycli.py]"]
  node_connection_guard["Connection guard<br/>[hooks.py]"]
end

subgraph group_auth["Authentication"]
  node_client["Play API client<br/>[gplaycli.py]"]
  node_token_auth["Token authentication<br/>[gplaycli.py]"]
  node_credential_auth["Credential authentication<br/>[gplaycli.py]"]
end

subgraph group_play["Play Store operations"]
  node_search["App search<br/>[gplaycli.py]"]
  node_download["APK download<br/>[gplaycli.py]"]
end

subgraph group_local["Local APK management"]
  node_update_check["Update check<br/>[gplaycli.py]"]
  node_apk_listing["APK listing<br/>[gplaycli.py]"]
  node_local_apks[("APK files")]
  node_file_helpers["File helpers<br/>[util.py]"]
  node_progress["Download progress<br/>[util.py]"]
end

node_user(("Operator"))
node_token_service{{"Token dispenser"}}
node_store{{"Google Play"}}

node_user -->|"runs commands"| node_cli
node_cli -->|"supports search"| node_search
node_cli -->|"supports download"| node_download
node_cli -->|"supports updates"| node_update_check
node_cli -->|"supports listing"| node_apk_listing
node_connection_guard -->|"checks connection"| node_client
node_connection_guard -.->|"connects if needed"| node_token_auth
node_token_auth -->|"requests token"| node_token_service
node_token_auth -->|"checks in and logs in"| node_client
node_credential_auth -->|"logs in"| node_client
node_search -->|"searches apps"| node_client
node_download -->|"fetches app data"| node_client
node_update_check -->|"reads APKs"| node_local_apks
node_update_check -->|"checks store versions"| node_client
node_apk_listing -.->|"lists APKs"| node_local_apks
node_download -->|"writes downloads"| node_local_apks
node_download -->|"updates progress"| node_progress
node_update_check -->|"parses versions"| node_file_helpers
node_apk_listing -.->|"finds APK files"| node_file_helpers

click node_cli "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_connection_guard "https://github.com/matlink/gplaycli/blob/master/gplaycli/hooks.py"
click node_client "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_token_auth "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_credential_auth "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_search "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_download "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_update_check "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_apk_listing "https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py"
click node_file_helpers "https://github.com/matlink/gplaycli/blob/master/gplaycli/util.py"
click node_progress "https://github.com/matlink/gplaycli/blob/master/gplaycli/util.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_connection_guard toneBlue
class node_client,node_token_auth,node_credential_auth toneAmber
class node_search,node_download toneMint
class node_update_check,node_apk_listing,node_local_apks,node_file_helpers,node_progress toneRose
class node_user,node_token_service,node_store toneIndigo
```

## Components

### CLI entry

- [CLI commands](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`
- [Connection guard](https://github.com/matlink/gplaycli/blob/master/gplaycli/hooks.py): `gplaycli/hooks.py`

### Authentication

- [Play API client](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`
- [Token authentication](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`
- [Credential authentication](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`

### Play Store operations

- [App search](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`
- [APK download](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`

### Local APK management

- [Update check](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`
- [APK listing](https://github.com/matlink/gplaycli/blob/master/gplaycli/gplaycli.py): `gplaycli/gplaycli.py`
- **APK files**
- [File helpers](https://github.com/matlink/gplaycli/blob/master/gplaycli/util.py): `gplaycli/util.py`
- [Download progress](https://github.com/matlink/gplaycli/blob/master/gplaycli/util.py): `gplaycli/util.py`

### Other components

- **Operator**
- **Token dispenser**
- **Google Play**

## Connections

- Operator → CLI commands: runs commands (evidence: `README.md`)
- CLI commands → App search: supports search (evidence: `README.md`)
- CLI commands → APK download: supports download (evidence: `README.md`)
- CLI commands → Update check: supports updates (evidence: `README.md`)
- CLI commands → APK listing: supports listing (evidence: `README.md`)
- Connection guard → Play API client: checks connection (evidence: `gplaycli/hooks.py`)
- Connection guard → Token authentication: connects if needed (evidence: `gplaycli/gplaycli.py`)
- Token authentication → Token dispenser: requests token (evidence: `gplaycli/gplaycli.py`)
- Token authentication → Play API client: checks in and logs in (evidence: `gplaycli/gplaycli.py`)
- Credential authentication → Play API client: logs in (evidence: `gplaycli/gplaycli.py`)
- App search → Play API client: searches apps (evidence: `gplaycli/gplaycli.py`)
- APK download → Play API client: fetches app data (evidence: `gplaycli/gplaycli.py`)
- Update check → APK files: reads APKs (evidence: `gplaycli/gplaycli.py`)
- Update check → Play API client: checks store versions (evidence: `gplaycli/gplaycli.py`)
- APK listing → APK files: lists APKs
- APK download → APK files: writes downloads (evidence: `gplaycli/gplaycli.py`)
- APK download → Download progress: updates progress (evidence: `gplaycli/gplaycli.py`)
- Update check → File helpers: parses versions (evidence: `gplaycli/gplaycli.py`)
- APK listing → File helpers: finds APK files (evidence: `gplaycli/gplaycli.py`)
