# alexch33/super-video-downloader architecture

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

- Interactive diagram: https://gitdiagram.com/alexch33/super-video-downloader
- Repository: https://github.com/alexch33/super-video-downloader

## Overview

1. **What this app is**
   - This is a native Android video/audio downloader centered around a built-in browser, video detection, offline playback, and several downloader engines.
   - The codebase is Kotlin-first, uses Android Views + DataBinding, and is organized around MVVM with repositories.

2. **Top-level app flow**
   - `DLApplication` boots the dependency graph and shared services.
   - The user typically enters through `SplashActivity`, then `MainActivity`.
   - From there the app navigates between browser/home, video details, downloads/progress, history, bookmarks, proxies, settings, help, and the player screens.

3. **UI layer boundaries**
   - The presentation layer is split into Activities and Fragments under `ui/main/*`.
   - `home/browser` is the most complex UI subtree: it hosts tabs, a WebView-based browser, and the detected-videos panel.
   - Each major screen has a paired ViewModel, and common base classes (`BaseActivity`, `BaseFragment`, `BaseViewModel`) provide shared lifecycle and state handling.

4. **Browser and web-content subsystem**
   - The browser is implemented with custom WebView clients/chrome clients and a tab system (`WebTab`, `WebTabFactory`, `CustomViewPager2`).
   - This layer is responsible for page navigation, tab management, page state, and capturing browser events that indicate media availability.
   - Browser-related state feeds into history/bookmarks/top pages and into video detection.

5. **Video detection and extraction**
   - Detected media is modeled separately from the browser UI via `detectedVideos/*`.
   - The app maintains a global detection model and detector interface so multiple pages/tabs can contribute candidate media entries.
   - Once media is detected, it is surfaced in the UI as selectable candidates and moved into the download/playback flows.

6. **Download engine subsystem**
   - Downloading is not a single implementation; it is split into multiple engines:
     - `generic_downloader` for task-based downloads
     - `custom_downloader` for regular/file-oriented downloads
     - `super_x_downloader` for segmented HLS/DASH/live-stream handling
     - `youtubedl_downloader` for youtube-dl style extraction/downloads
   - The `super_x_downloader` subtree includes dedicated strategies for HLS, DASH/MPD, and live variants, which is the main architecture for advanced stream types.

7. **Background execution and user feedback**
   - Downloader workers (`*Worker`) indicate background job execution, likely via Android WorkManager.
   - Progress is persisted and shown in the progress screen, while notifications are handled through `NotificationsHelper` and downloader notification receivers.
   - This gives the app a clear split between foreground selection/UI and background transfer execution.

8. **Local persistence**
   - Persistent app state is backed by Room under `data/local/room`.
   - Separate entities/DAOs handle videos, progress, history, config, and supported pages.
   - The Room schemas checked into `app/schemas` show that the database is versioned and migrated over time, which is important for long-term state compatibility.

9. **Remote data and app configuration**
   - `data/remote` contains services and data sources for configuration and supported pages.
   - The app likely refreshes site support, top pages, and related metadata from remote endpoints instead of hardcoding all supported sources.
   - `ConfigRepository`, `TopPagesRepository`, and `VideoRepository` bridge these remote sources into the rest of the app.

10. **Networking, proxying, and privacy**
   - The app has a dedicated proxy subsystem under `util/proxy_utils` plus `v2ray/V2Ray.kt`.
   - Traffic can be routed through configurable proxies, with retry/interception support and support for encrypted DNS as described in the README.
   - This matters architecturally because browser traffic, extractor traffic, and download traffic may all need to flow through the proxy layer.

11. **Shared utilities and media processing**
   - Utilities cover cookies, file handling, intents, notifications, favicon handling, time/memory helpers, and video-specific helpers.
   - `FfmpegProcessor` and playlist parsers (`hls_parser`) support media-processing tasks that are adjacent to download/extraction.
   - These utilities are not a separate subsystem, but they are key dependencies for the downloader and browser flows.

12. **Dependency injection and composition**
   - Dagger 2 is used to assemble the app graph through `AppComponent` and modules for database, network, repositories, view models, workers, and utilities.
   - Custom qualifiers distinguish application vs activity context and local vs remote data sources.
   - This is the main boundary that wires UI, repositories, network clients, and storage together.

13. **Build and packaging tooling**
   - The project is an Android Gradle build with Kotlin DSL.
   - There is a small Go-based builder under `app/src/main/go/builder`, and the README exposes a task for vendoring Go dependencies.
   - Fastlane metadata, GitHub/GitLab CI, and schema snapshots indicate the app is actively packaged and release-managed across platforms.

14. **Important architectural takeaway**
   - The app’s core data flow is: browser/WebView activity → media detection → candidate selection → repository-backed download task → background worker/downloader engine → progress/notification updates → persisted history/download state.
   - The main architectural boundaries are UI, repositories, local/remote data sources, network/proxy infrastructure, and specialized downloader engines.

Main entry points: [`app/src/main/java/com/myAllVideoBrowser/ui/main/video/VideoFragment.kt`](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/video/VideoFragment.kt) (Video screen), [`app/src/main/java/com/myAllVideoBrowser/ui/main/progress/ProgressFragment.kt`](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/progress/ProgressFragment.kt) (Progress), [`app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/BrowserFragment.kt`](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/BrowserFragment.kt) (Browser), [`app/src/main/java/com/myAllVideoBrowser/data/repository/VideoRepository.kt`](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/repository/VideoRepository.kt) (Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g_app["App shell"]
  node_n_app["DLApplication<br/>application bootstrap<br/>[DLApplication.kt]"]
  node_n_splash["Splash<br/>startup screen<br/>[SplashActivity.kt]"]
  node_n_main["Main activity<br/>app shell<br/>[MainActivity.kt]"]
  node_n_homevm["Main VM<br/>view model<br/>[MainViewModel.kt]"]
end

subgraph group_g_browser["Browser + media"]
  node_n_browser["Browser<br/>web hub<br/>[BrowserFragment.kt]"]
  node_n_webtab["Web tab<br/>tab runtime<br/>[WebTab.kt]"]
  node_n_tabfactory["Tab factory<br/>tab builder<br/>[WebTabFactory.kt]"]
  node_n_webclient["Web clients<br/>WebView hooks"]
  node_n_detect["Video detect<br/>detection model"]
  node_n_video_ui["Video screen<br/>candidate screen<br/>[VideoFragment.kt]"]
  node_n_player["Player<br/>playback screen"]
end

subgraph group_g_downloads["Download engines"]
  node_n_progress["Progress<br/>status screen"]
  node_n_genericdl["Generic DL<br/>task downloader"]
  node_n_customdl["Custom DL<br/>file downloader"]
  node_n_superx["SuperX<br/>stream downloader"]
  node_n_ydl["YTDL<br/>extractor downloader"]
end

subgraph group_g_data["Data layer"]
  node_n_room[("Room DB<br/>local database<br/>[AppDatabase.kt]")]
  node_n_repo["Repositories<br/>data facade<br/>[VideoRepository.kt]"]
  node_n_remote["Remote API<br/>network services<br/>[VideoService.kt]"]
  node_n_local["Local sources<br/>room datasources"]
end

subgraph group_g_infra["Infrastructure"]
  node_n_di["Dagger graph<br/>composition root<br/>[AppComponent.kt]"]
  node_n_proxy["Proxy layer<br/>network routing"]
  node_n_utils["Utilities<br/>shared helpers<br/>[AppUtil.kt]"]
end

node_n_app -->|"builds"| node_n_di
node_n_app -->|"starts"| node_n_splash
node_n_splash -->|"opens"| node_n_main
node_n_main -->|"hosts"| node_n_browser
node_n_main -->|"navigates"| node_n_progress
node_n_browser -->|"manages"| node_n_webtab
node_n_browser -->|"creates"| node_n_tabfactory
node_n_browser -->|"observes"| node_n_webclient
node_n_webclient -->|"feeds"| node_n_detect
node_n_detect -->|"surfaces"| node_n_video_ui
node_n_video_ui -->|"requests"| node_n_repo
node_n_repo -->|"reads/writes"| node_n_local
node_n_repo -->|"fetches"| node_n_remote
node_n_repo -->|"stores"| node_n_room
node_n_video_ui -->|"starts"| node_n_genericdl
node_n_video_ui -->|"starts"| node_n_customdl
node_n_video_ui -->|"starts"| node_n_superx
node_n_video_ui -->|"starts"| node_n_ydl
node_n_genericdl -->|"reports"| node_n_progress
node_n_customdl -->|"reports"| node_n_progress
node_n_superx -->|"reports"| node_n_progress
node_n_ydl -->|"reports"| node_n_progress
node_n_genericdl -->|"routes through"| node_n_proxy
node_n_superx -->|"uses"| node_n_utils
node_n_proxy -->|"uses"| node_n_utils
node_n_di -->|"provides"| node_n_remote
node_n_di -->|"provides"| node_n_room
node_n_di -->|"provides"| node_n_utils

click node_n_app "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/DLApplication.kt"
click node_n_splash "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/splash/SplashActivity.kt"
click node_n_main "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/MainActivity.kt"
click node_n_homevm "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/MainViewModel.kt"
click node_n_browser "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/BrowserFragment.kt"
click node_n_webtab "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/webTab/WebTab.kt"
click node_n_tabfactory "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/webTab/WebTabFactory.kt"
click node_n_webclient "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/CustomWebViewClient.kt"
click node_n_detect "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/detectedVideos/GlobalVideoDetectionModel.kt"
click node_n_video_ui "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/video/VideoFragment.kt"
click node_n_player "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/player/VideoPlayerActivity.kt"
click node_n_progress "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/progress/ProgressFragment.kt"
click node_n_genericdl "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/generic_downloader/GenericDownloader.kt"
click node_n_customdl "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/custom_downloader/CustomRegularDownloader.kt"
click node_n_superx "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/super_x_downloader/SuperXDownloader.kt"
click node_n_ydl "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/youtubedl_downloader/YoutubeDlDownloader.kt"
click node_n_room "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/local/room/AppDatabase.kt"
click node_n_repo "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/repository/VideoRepository.kt"
click node_n_remote "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/remote/service/VideoService.kt"
click node_n_local "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/local/VideoLocalDataSource.kt"
click node_n_di "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/di/component/AppComponent.kt"
click node_n_proxy "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/proxy_utils/CustomProxyController.kt"
click node_n_utils "https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/AppUtil.kt"

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_n_app,node_n_splash,node_n_main,node_n_homevm toneBlue
class node_n_browser,node_n_webtab,node_n_tabfactory,node_n_webclient,node_n_detect,node_n_video_ui,node_n_player toneAmber
class node_n_progress,node_n_genericdl,node_n_customdl,node_n_superx,node_n_ydl toneMint
class node_n_room,node_n_repo,node_n_remote,node_n_local toneRose
class node_n_di,node_n_proxy,node_n_utils toneIndigo
```

## Components

### App shell

Application bootstrap and screen navigation

- [DLApplication](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/DLApplication.kt): application bootstrap · Initializes dependency graph and shared services · `app/src/main/java/com/myAllVideoBrowser/DLApplication.kt`
- [Splash](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/splash/SplashActivity.kt): startup screen · Entry activity before main UI · `app/src/main/java/com/myAllVideoBrowser/ui/main/splash/SplashActivity.kt`
- [Main activity](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/MainActivity.kt): app shell · Hosts the primary navigation and fragments · `app/src/main/java/com/myAllVideoBrowser/ui/main/home/MainActivity.kt`
- [Main VM](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/MainViewModel.kt): view model · Coordinates top-level home state · `app/src/main/java/com/myAllVideoBrowser/ui/main/home/MainViewModel.kt`

### Browser + media

WebView browsing, tab management, and video detection

- [Browser](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/BrowserFragment.kt): web hub · Main browser container and navigation surface · `app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/BrowserFragment.kt`
- [Web tab](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/webTab/WebTab.kt): tab runtime · Represents a browser tab and its state · `app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/webTab/WebTab.kt`
- [Tab factory](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/webTab/WebTabFactory.kt): tab builder · Creates web tab instances · `app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/webTab/WebTabFactory.kt`
- [Web clients](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/CustomWebViewClient.kt): WebView hooks · Custom chrome and page clients for browser events · `app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/CustomWebViewClient.kt`
- [Video detect](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/detectedVideos/GlobalVideoDetectionModel.kt): detection model · Collects detected media candidates across tabs · `app/src/main/java/com/myAllVideoBrowser/ui/main/home/browser/detectedVideos/GlobalVideoDetectionModel.kt`
- [Video screen](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/video/VideoFragment.kt): candidate screen · Shows detected videos and selection details · `app/src/main/java/com/myAllVideoBrowser/ui/main/video/VideoFragment.kt`
- [Player](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/player/VideoPlayerActivity.kt): playback screen · Offline playback and media viewing · `app/src/main/java/com/myAllVideoBrowser/ui/main/player/VideoPlayerActivity.kt`

### Download engines

Background transfer execution and media processing

- [Progress](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/ui/main/progress/ProgressFragment.kt): status screen · Displays download and transfer progress · `app/src/main/java/com/myAllVideoBrowser/ui/main/progress/ProgressFragment.kt`
- [Generic DL](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/generic_downloader/GenericDownloader.kt): task downloader · Task-oriented downloader engine · `app/src/main/java/com/myAllVideoBrowser/util/downloaders/generic_downloader/GenericDownloader.kt`
- [Custom DL](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/custom_downloader/CustomRegularDownloader.kt): file downloader · Regular file and direct download engine · `app/src/main/java/com/myAllVideoBrowser/util/downloaders/custom_downloader/CustomRegularDownloader.kt`
- [SuperX](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/super_x_downloader/SuperXDownloader.kt): stream downloader · Segmented HLS/DASH/live download engine · `app/src/main/java/com/myAllVideoBrowser/util/downloaders/super_x_downloader/SuperXDownloader.kt`
- [YTDL](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/downloaders/youtubedl_downloader/YoutubeDlDownloader.kt): extractor downloader · youtube-dl style extraction and download path · `app/src/main/java/com/myAllVideoBrowser/util/downloaders/youtubedl_downloader/YoutubeDlDownloader.kt`

### Data layer

Local storage, remote services, and repositories

- [Room DB](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/local/room/AppDatabase.kt): local database · Persisted app state and schemas · `app/src/main/java/com/myAllVideoBrowser/data/local/room/AppDatabase.kt`
- [Repositories](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/repository/VideoRepository.kt): data facade · Bridges UI to local and remote sources · `app/src/main/java/com/myAllVideoBrowser/data/repository/VideoRepository.kt`
- [Remote API](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/remote/service/VideoService.kt): network services · Configuration, search, and video services · `app/src/main/java/com/myAllVideoBrowser/data/remote/service/VideoService.kt`
- [Local sources](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/data/local/VideoLocalDataSource.kt): room datasources · Local data sources and Room-backed DAOs · `app/src/main/java/com/myAllVideoBrowser/data/local/VideoLocalDataSource.kt`

### Infrastructure

Dependency injection, proxying, and shared utilities

- [Dagger graph](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/di/component/AppComponent.kt): composition root · App component and modules wiring dependencies · `app/src/main/java/com/myAllVideoBrowser/di/component/AppComponent.kt`
- [Proxy layer](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/proxy_utils/CustomProxyController.kt): network routing · Proxy controller, OkHttp proxying, and V2Ray support · `app/src/main/java/com/myAllVideoBrowser/util/proxy_utils/CustomProxyController.kt`
- [Utilities](https://github.com/alexch33/super-video-downloader/blob/master/app/src/main/java/com/myAllVideoBrowser/util/AppUtil.kt): shared helpers · Cookies, files, notifications, media processing, and parsers · `app/src/main/java/com/myAllVideoBrowser/util/AppUtil.kt`

## Connections

- DLApplication → Dagger graph: builds · Application creates the dependency graph
- DLApplication → Splash: starts · Boot flow enters the splash activity
- Splash → Main activity: opens · Splash hands off to the main shell
- Main activity → Browser: hosts · Main activity displays the browser hub
- Main activity → Progress: navigates · Main shell can show download progress
- Browser → Web tab: manages · Browser coordinates multiple tab runtimes
- Browser → Tab factory: creates · Tabs are instantiated through a factory
- Browser → Web clients: observes · Web clients capture page and media events
- Web clients → Video detect: feeds · Browser events populate media candidates
- Video detect → Video screen: surfaces · Detected media is shown for selection
- Video screen → Repositories: requests · Selection moves into repository-backed tasks
- Repositories → Local sources: reads/writes · Repositories persist and query local state
- Repositories → Remote API: fetches · Repositories refresh remote metadata and support data
- Repositories → Room DB: stores · Local state is backed by Room
- Video screen → Generic DL: starts · Selected media can use task-based download
- Video screen → Custom DL: starts · Direct file downloads go through the custom engine
- Video screen → SuperX: starts · Segmented streams use the advanced engine
- Video screen → YTDL: starts · Extractor-driven sources use youtube-dl path
- Generic DL → Progress: reports · Background jobs update progress UI
- Custom DL → Progress: reports · File downloads update progress UI
- SuperX → Progress: reports · Stream segment downloads update progress UI
- YTDL → Progress: reports · Extractor downloads update progress UI
- Generic DL → Proxy layer: routes through · Download traffic can be proxied
- SuperX → Utilities: uses · Stream handling relies on parsers and media helpers
- Proxy layer → Utilities: uses · Proxy stack relies on shared networking helpers
- Dagger graph → Remote API: provides · DI wires network services
- Dagger graph → Room DB: provides · DI wires database and DAOs
- Dagger graph → Utilities: provides · DI wires helpers, workers, and factories
