# gaurav7902/qualitytube architecture

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

- Interactive diagram: https://gitdiagram.com/gaurav7902/qualitytube
- Repository: https://github.com/gaurav7902/qualitytube

## Overview

QualityTube is a cross-browser YouTube extension that waits for ads to end, chooses the highest eligible quality, and verifies that YouTube accepted it. The main workflow runs in the page content script; the popup stores enablement, Premium eligibility, and restart preferences. README documentation also describes Super Resolution priority, fallback after rejected choices, and per-video session handling. The Chromium and Firefox implementations are parallel. The excerpts show the controller and popup storage behavior, but do not expose all internal call sites, so the graph keeps the selection workflow together rather than guessing at finer-grained links.

Main entry points: [`extension/chromium-based/content.js`](https://github.com/gaurav7902/qualitytube/blob/main/extension/chromium-based/content.js) (YouTube quality controller), [`extension/firefox/content.js`](https://github.com/gaurav7902/qualitytube/blob/main/extension/firefox/content.js) (YouTube quality controller), [`extension/chromium-based/popup.js`](https://github.com/gaurav7902/qualitytube/blob/main/extension/chromium-based/popup.js) (Settings popup), [`extension/firefox/popup.js`](https://github.com/gaurav7902/qualitytube/blob/main/extension/firefox/popup.js) (Settings popup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Page runtime"]
  node_chromium_controller["YouTube quality controller<br/>[content.js]"]
  node_firefox_controller["YouTube quality controller<br/>[content.js]"]
  node_youtube_player["YouTube player"]
end

subgraph group_settings["Preferences"]
  node_chromium_popup["Settings popup<br/>[popup.js]"]
  node_firefox_popup["Settings popup<br/>[popup.js]"]
end

subgraph group_platform["Browser platform"]
  node_browser_storage[("Extension storage")]
end

node_viewer(("YouTube viewer"))

node_viewer -->|"plays video"| node_youtube_player
node_youtube_player -->|"signals updates"| node_chromium_controller
node_youtube_player -->|"signals updates"| node_firefox_controller
node_chromium_controller -->|"selects quality"| node_youtube_player
node_firefox_controller -->|"selects quality"| node_youtube_player
node_chromium_popup -->|"reads and writes"| node_browser_storage
node_firefox_popup -->|"reads and writes"| node_browser_storage
node_chromium_controller -->|"reads preferences"| node_browser_storage
node_firefox_controller -->|"reads preferences"| node_browser_storage

click node_chromium_controller "https://github.com/gaurav7902/qualitytube/blob/main/extension/chromium-based/content.js"
click node_firefox_controller "https://github.com/gaurav7902/qualitytube/blob/main/extension/firefox/content.js"
click node_chromium_popup "https://github.com/gaurav7902/qualitytube/blob/main/extension/chromium-based/popup.js"
click node_firefox_popup "https://github.com/gaurav7902/qualitytube/blob/main/extension/firefox/popup.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_chromium_controller,node_firefox_controller,node_youtube_player,node_viewer toneBlue
class node_chromium_popup,node_firefox_popup toneAmber
class node_browser_storage toneMint
```

## Components

### Page runtime

- [YouTube quality controller](https://github.com/gaurav7902/qualitytube/blob/main/extension/chromium-based/content.js): `extension/chromium-based/content.js`
- [YouTube quality controller](https://github.com/gaurav7902/qualitytube/blob/main/extension/firefox/content.js): `extension/firefox/content.js`
- **YouTube player**

### Preferences

- [Settings popup](https://github.com/gaurav7902/qualitytube/blob/main/extension/chromium-based/popup.js): `extension/chromium-based/popup.js`
- [Settings popup](https://github.com/gaurav7902/qualitytube/blob/main/extension/firefox/popup.js): `extension/firefox/popup.js`

### Browser platform

- **Extension storage**

### Other components

- **YouTube viewer**

## Connections

- YouTube viewer → YouTube player: plays video (evidence: `README.md`)
- YouTube player → YouTube quality controller: signals updates (evidence: `extension/chromium-based/content.js`)
- YouTube player → YouTube quality controller: signals updates (evidence: `extension/firefox/content.js`)
- YouTube quality controller → YouTube player: selects quality (evidence: `README.md`)
- YouTube quality controller → YouTube player: selects quality (evidence: `README.md`)
- Settings popup → Extension storage: reads and writes (evidence: `extension/chromium-based/popup.js`)
- Settings popup → Extension storage: reads and writes (evidence: `extension/firefox/popup.js`)
- YouTube quality controller → Extension storage: reads preferences (evidence: `extension/chromium-based/content.js`)
- YouTube quality controller → Extension storage: reads preferences (evidence: `extension/firefox/content.js`)
