# gylive/google-ultra architecture

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

- Interactive diagram: https://gitdiagram.com/gylive/google-ultra
- Repository: https://github.com/gylive/google-ultra

## Overview

google-ultra is a local proof-of-concept for finding and activating Google Play’s hidden Google One Ultra trial. It offers a browser-based flow and a Frida/ADB script flow; the latter checks the device, prepares and verifies the target Play account, queries BillingClient offers through Google One, selects a free trial, confirms checkout, and verifies the subscription. The README documents these stages and the browser flow; sampled Python excerpts show offer-event handling and script loading. The web implementation and much of the scripts were not sampled, so their internal relationships are based on README statements.

Main entry points: [`ultra0.py`](https://github.com/gylive/google-ultra/blob/main/ultra0.py) (Script Entry), [`web/index.html`](https://github.com/gylive/google-ultra/blob/main/web/index.html) (Browser Offer Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser Flow"]
  node_web["Browser Offer Page<br/>[index.html]"]
end

subgraph group_script["Device Script"]
  node_cli["Script Entry<br/>[ultra0.py]"]
  node_check["Device Preflight<br/>[ultra0.py]"]
  node_accounts["Account Setup and Switch<br/>[ultra0.py]"]
  node_verification["Subscription Verification<br/>[ultra0.py]"]
  node_report["Run Report<br/>[ultra0.py]"]
end

subgraph group_billing["Billing Workflow"]
  node_frida["Frida Billing Probe<br/>[ultra0.py]"]
  node_offers["Offer Discovery<br/>[ultra0.py]"]
  node_selection["Free Offer Selection<br/>[ultra0.py]"]
  node_checkout["Checkout Confirmation<br/>[ultra0.py]"]
end

subgraph group_external["External Systems"]
  node_browser_google["Google Sign-in and Checkout"]
  node_one["Google One Client"]
  node_billing_client["Play BillingClient"]
  node_device["Rooted Android Device"]
  node_play["Google Play"]
end

node_user(("User"))

node_user -->|"opens"| node_web
node_web -->|"directs to"| node_browser_google
node_user -->|"runs"| node_cli
node_cli -->|"checks"| node_check
node_cli -->|"prepares account"| node_accounts
node_accounts -->|"adds and switches"| node_device
node_accounts -->|"verifies account"| node_play
node_cli -->|"starts probe"| node_frida
node_frida -->|"attaches to"| node_one
node_frida -->|"queries offers"| node_billing_client
node_frida -->|"reports offers"| node_offers
node_offers -->|"selects free trial"| node_selection
node_selection -->|"launches flow"| node_checkout
node_checkout -->|"confirms purchase"| node_play
node_cli -->|"verifies subscription"| node_verification
node_verification -->|"opens subscription page"| node_play
node_cli -->|"writes results"| node_report

click node_web "https://github.com/gylive/google-ultra/blob/main/web/index.html"
click node_cli "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_check "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_accounts "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_frida "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_offers "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_selection "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_checkout "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_verification "https://github.com/gylive/google-ultra/blob/main/ultra0.py"
click node_report "https://github.com/gylive/google-ultra/blob/main/ultra0.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_web,node_user toneBlue
class node_cli,node_check,node_accounts,node_verification,node_report toneAmber
class node_frida,node_offers,node_selection,node_checkout toneMint
class node_browser_google,node_one,node_billing_client,node_device,node_play toneRose
```

## Components

### Browser Flow

- [Browser Offer Page](https://github.com/gylive/google-ultra/blob/main/web/index.html): `web/index.html`

### Device Script

- [Script Entry](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`
- [Device Preflight](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`
- [Account Setup and Switch](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`
- [Subscription Verification](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`
- [Run Report](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`

### Billing Workflow

- [Frida Billing Probe](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`
- [Offer Discovery](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`
- [Free Offer Selection](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`
- [Checkout Confirmation](https://github.com/gylive/google-ultra/blob/main/ultra0.py): `ultra0.py`

### External Systems

- **Google Sign-in and Checkout**
- **Google One Client**
- **Play BillingClient**
- **Rooted Android Device**
- **Google Play**

### Other components

- **User**

## Connections

- User → Browser Offer Page: opens (evidence: `README.md`)
- Browser Offer Page → Google Sign-in and Checkout: directs to (evidence: `README.md`)
- User → Script Entry: runs (evidence: `README.md`)
- Script Entry → Device Preflight: checks (evidence: `README.md`)
- Script Entry → Account Setup and Switch: prepares account (evidence: `README.md`)
- Account Setup and Switch → Rooted Android Device: adds and switches (evidence: `README.md`)
- Account Setup and Switch → Google Play: verifies account (evidence: `README.md`)
- Script Entry → Frida Billing Probe: starts probe (evidence: `README.md`)
- Frida Billing Probe → Google One Client: attaches to (evidence: `README.md`)
- Frida Billing Probe → Play BillingClient: queries offers (evidence: `ultra0.py`)
- Frida Billing Probe → Offer Discovery: reports offers (evidence: `ultra0.py`)
- Offer Discovery → Free Offer Selection: selects free trial (evidence: `README.md`)
- Free Offer Selection → Checkout Confirmation: launches flow (evidence: `README.md`)
- Checkout Confirmation → Google Play: confirms purchase (evidence: `README.md`)
- Script Entry → Subscription Verification: verifies subscription (evidence: `README.md`)
- Subscription Verification → Google Play: opens subscription page (evidence: `README.md`)
- Script Entry → Run Report: writes results (evidence: `README.md`)
