# prateek-chaubey/ytpro architecture

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

- Interactive diagram: https://gitdiagram.com/prateek-chaubey/ytpro
- Repository: https://github.com/prateek-chaubey/ytpro

## Overview

YT PRO is an Android YouTube WebView app augmented by injected JavaScript. Users browse YouTube in the embedded view, where the app adds playback and convenience features; JavaScript can also request downloads, media muxing, Gemini assistance, and background playback through the Android bridge. The map includes these documented capabilities, but the JavaScript feature implementations and several Android modules were not excerpted, so their internal links are limited to documented or visible wiring.

Main entry points: [`app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java`](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java) (JavaScript bridge), [`app/src/main/java/com/google/android/youtube/pro/MainActivity.java`](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/MainActivity.java) (Activity host), [`app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java`](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java) (Request injector), [`app/src/main/java/com/google/android/youtube/pro/webview/YTProWebView.java`](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebView.java) (YouTube WebView)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android App"]
  node_main["Activity host<br/>[MainActivity.java]"]
end

subgraph group_web["WebView Runtime"]
  node_webview["YouTube WebView<br/>[YTProWebView.java]"]
  node_webclient["Request injector"]
  node_chrome["Chrome handlers"]
  node_bridge["JavaScript bridge"]
  node_injected["YouTube enhancements<br/>[script.js]"]
  node_bgjs["Background player script<br/>[bgplay.js]"]
  node_innertube["YouTube API script<br/>[innertube.js]"]
end

subgraph group_media["Media Features"]
  node_stream["Binary downloads"]
  node_download["Download utilities<br/>[DownloadUtils.java]"]
  node_muxer["Audio video muxer"]
  node_service["Background playback"]
  node_notify["Notification actions"]
  node_commands["Media commands"]
end

subgraph group_ai["Gemini Integration"]
  node_gemini["Gemini client<br/>[GeminiWrapper.java]"]
end

node_user(("App user"))
node_youtube["YouTube service"]
node_storage[("Android downloads store")]
node_geminisvc["Google Gemini"]

node_user -->|"opens"| node_main
node_main -->|"hosts"| node_webview
node_main -->|"registers"| node_bridge
node_main -->|"configures"| node_chrome
node_main -->|"configures"| node_webclient
node_webview -->|"browses"| node_youtube
node_webclient -->|"fetches"| node_youtube
node_webclient -->|"loads script"| node_injected
node_webclient -->|"loads script"| node_bgjs
node_webclient -->|"loads script"| node_innertube
node_injected -.->|"requests features"| node_bridge
node_bgjs -.->|"requests playback"| node_bridge
node_bridge -->|"opens stream"| node_stream
node_stream -->|"writes files"| node_storage
node_bridge -.->|"delegates downloads"| node_download
node_bridge -->|"starts muxing"| node_muxer
node_muxer -->|"writes output"| node_storage
node_bridge -->|"starts service"| node_service
node_service -->|"creates actions"| node_notify
node_notify -->|"broadcasts action"| node_commands
node_main -->|"registers receiver"| node_commands
node_commands -->|"dispatches playback"| node_webview
node_bridge -->|"calls client"| node_gemini
node_gemini -->|"sends requests"| node_geminisvc

click node_main "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/MainActivity.java"
click node_webview "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebView.java"
click node_webclient "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java"
click node_chrome "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebChromeClient.java"
click node_bridge "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java"
click node_stream "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/BinaryStreamManager.java"
click node_download "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/utils/DownloadUtils.java"
click node_muxer "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/utils/MediaMuxerUtils.java"
click node_service "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/ForegroundService.java"
click node_notify "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/receivers/NotificationActionReceiver.java"
click node_commands "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/receivers/MediaCommandReceiver.java"
click node_gemini "https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/GeminiWrapper.java"
click node_injected "https://github.com/prateek-chaubey/ytpro/blob/main/scripts/script.js"
click node_bgjs "https://github.com/prateek-chaubey/ytpro/blob/main/scripts/bgplay.js"
click node_innertube "https://github.com/prateek-chaubey/ytpro/blob/main/scripts/innertube.js"

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_main,node_user toneBlue
class node_webview,node_webclient,node_chrome,node_bridge,node_injected,node_bgjs,node_innertube,node_storage toneAmber
class node_stream,node_download,node_muxer,node_service,node_notify,node_commands toneMint
class node_gemini toneRose
class node_youtube,node_geminisvc toneIndigo
```

## Components

### Android App

- [Activity host](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/MainActivity.java): `app/src/main/java/com/google/android/youtube/pro/MainActivity.java`

### WebView Runtime

- [YouTube WebView](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebView.java): `app/src/main/java/com/google/android/youtube/pro/webview/YTProWebView.java`
- [Request injector](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java): `app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java`
- [Chrome handlers](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/YTProWebChromeClient.java): `app/src/main/java/com/google/android/youtube/pro/webview/YTProWebChromeClient.java`
- [JavaScript bridge](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java): `app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java`
- [YouTube enhancements](https://github.com/prateek-chaubey/ytpro/blob/main/scripts/script.js): `scripts/script.js`
- [Background player script](https://github.com/prateek-chaubey/ytpro/blob/main/scripts/bgplay.js): `scripts/bgplay.js`
- [YouTube API script](https://github.com/prateek-chaubey/ytpro/blob/main/scripts/innertube.js): `scripts/innertube.js`

### Media Features

- [Binary downloads](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/webview/BinaryStreamManager.java): `app/src/main/java/com/google/android/youtube/pro/webview/BinaryStreamManager.java`
- [Download utilities](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/utils/DownloadUtils.java): `app/src/main/java/com/google/android/youtube/pro/utils/DownloadUtils.java`
- [Audio video muxer](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/utils/MediaMuxerUtils.java): `app/src/main/java/com/google/android/youtube/pro/utils/MediaMuxerUtils.java`
- [Background playback](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/ForegroundService.java): `app/src/main/java/com/google/android/youtube/pro/ForegroundService.java`
- [Notification actions](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/receivers/NotificationActionReceiver.java): `app/src/main/java/com/google/android/youtube/pro/receivers/NotificationActionReceiver.java`
- [Media commands](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/receivers/MediaCommandReceiver.java): `app/src/main/java/com/google/android/youtube/pro/receivers/MediaCommandReceiver.java`

### Gemini Integration

- [Gemini client](https://github.com/prateek-chaubey/ytpro/blob/main/app/src/main/java/com/google/android/youtube/pro/GeminiWrapper.java): `app/src/main/java/com/google/android/youtube/pro/GeminiWrapper.java`

### Other components

- **App user**
- **YouTube service**
- **Android downloads store**
- **Google Gemini**

## Connections

- App user → Activity host: opens (evidence: `README.md`)
- Activity host → YouTube WebView: hosts (evidence: `app/src/main/java/com/google/android/youtube/pro/MainActivity.java`)
- Activity host → JavaScript bridge: registers (evidence: `app/src/main/java/com/google/android/youtube/pro/MainActivity.java`)
- Activity host → Chrome handlers: configures (evidence: `app/src/main/java/com/google/android/youtube/pro/MainActivity.java`)
- Activity host → Request injector: configures (evidence: `app/src/main/java/com/google/android/youtube/pro/MainActivity.java`)
- YouTube WebView → YouTube service: browses (evidence: `README.md`)
- Request injector → YouTube service: fetches (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java`)
- Request injector → YouTube enhancements: loads script (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java`)
- Request injector → Background player script: loads script (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java`)
- Request injector → YouTube API script: loads script (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/YTProWebViewClient.java`)
- YouTube enhancements → JavaScript bridge: requests features
- Background player script → JavaScript bridge: requests playback
- JavaScript bridge → Binary downloads: opens stream (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java`)
- Binary downloads → Android downloads store: writes files (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/BinaryStreamManager.java`)
- JavaScript bridge → Download utilities: delegates downloads (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java`)
- JavaScript bridge → Audio video muxer: starts muxing (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java`)
- Audio video muxer → Android downloads store: writes output (evidence: `app/src/main/java/com/google/android/youtube/pro/utils/MediaMuxerUtils.java`)
- JavaScript bridge → Background playback: starts service (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java`)
- Background playback → Notification actions: creates actions (evidence: `app/src/main/java/com/google/android/youtube/pro/ForegroundService.java`)
- Notification actions → Media commands: broadcasts action (evidence: `app/src/main/java/com/google/android/youtube/pro/receivers/NotificationActionReceiver.java`)
- Activity host → Media commands: registers receiver (evidence: `app/src/main/java/com/google/android/youtube/pro/MainActivity.java`)
- Media commands → YouTube WebView: dispatches playback (evidence: `app/src/main/java/com/google/android/youtube/pro/receivers/MediaCommandReceiver.java`)
- JavaScript bridge → Gemini client: calls client (evidence: `app/src/main/java/com/google/android/youtube/pro/webview/WebAppInterface.java`)
- Gemini client → Google Gemini: sends requests (evidence: `app/src/main/java/com/google/android/youtube/pro/GeminiWrapper.java`)
