# iawia002/lux architecture

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

- Interactive diagram: https://gitdiagram.com/iawia002/lux
- Repository: https://github.com/iawia002/lux

## Overview

Lux is a Go video and media downloader. The user supplies one or more URLs; the CLI configures request and download options, dispatches to a site extractor (or universal direct-resource handler), then passes extracted media metadata and streams to the downloader for transfer and optional file processing. Playlist support and broad site coverage are documented. Source evidence is partial, so links for the dispatch registry and unsampled subsystems are limited to documented or indexed relationships.

Main entry points: [`extractors/extractors.go`](https://github.com/iawia002/lux/blob/master/extractors/extractors.go) (Extractor API), [`request/request.go`](https://github.com/iawia002/lux/blob/master/request/request.go) (HTTP requests), [`downloader/downloader.go`](https://github.com/iawia002/lux/blob/master/downloader/downloader.go) (Stream downloader), [`app/app.go`](https://github.com/iawia002/lux/blob/master/app/app.go) (CLI app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI orchestration"]
  node_cli["CLI app<br/>[app.go]"]
  node_registry["Extractor registry<br/>[register.go]"]
end

subgraph group_extract["Extraction"]
  node_extractor_api["Extractor API<br/>[extractors.go]"]
  node_bilibili["Bilibili<br/>[bilibili.go]"]
  node_rumble["Rumble<br/>[rumble.go]"]
  node_weibo["Weibo<br/>[weibo.go]"]
  node_youku["Youku<br/>[youku.go]"]
  node_iqiyi["iQIYI<br/>[iqiyi.go]"]
  node_qq["QQ Video<br/>[qq.go]"]
  node_site_extractors["Other site extractors"]
  node_universal["Direct resource<br/>[universal.go]"]
end

subgraph group_network["Network and media"]
  node_request["HTTP requests<br/>[request.go]"]
  node_parser["Content parsing<br/>[parser.go]"]
  node_media_utils["Media utilities<br/>[utils.go]"]
end

subgraph group_transfer["Download output"]
  node_downloader["Stream downloader<br/>[downloader.go]"]
  node_file_utils["File operations<br/>[download.go]"]
  node_ffmpeg["FFmpeg processing<br/>[ffmpeg.go]"]
  node_media_files[("Media files")]
end

node_user(("User"))

node_user -->|"supplies URLs"| node_cli
node_cli -.->|"dispatches extraction"| node_registry
node_registry -.->|"selects handler"| node_extractor_api
node_extractor_api -.->|"extracts streams"| node_bilibili
node_extractor_api -.->|"extracts streams"| node_rumble
node_extractor_api -.->|"extracts streams"| node_weibo
node_extractor_api -.->|"extracts streams"| node_youku
node_extractor_api -.->|"extracts streams"| node_iqiyi
node_extractor_api -.->|"extracts streams"| node_qq
node_extractor_api -.->|"supports sites"| node_site_extractors
node_extractor_api -.->|"handles direct URLs"| node_universal
node_cli -->|"sets options"| node_request
node_bilibili -->|"fetches metadata"| node_request
node_rumble -.->|"fetches metadata"| node_request
node_weibo -->|"fetches metadata"| node_request
node_youku -.->|"fetches metadata"| node_request
node_iqiyi -->|"fetches metadata"| node_request
node_qq -->|"fetches metadata"| node_request
node_site_extractors -.->|"fetches metadata"| node_request
node_bilibili -.->|"parses media data"| node_media_utils
node_iqiyi -.->|"parses page data"| node_parser
node_rumble -.->|"resolves playlists"| node_media_utils
node_cli -->|"downloads extracted data"| node_downloader
node_downloader -->|"fetches stream parts"| node_request
node_downloader -.->|"uses file helpers"| node_file_utils
node_downloader -.->|"embeds subtitles"| node_ffmpeg
node_downloader -->|"writes media"| node_media_files

click node_cli "https://github.com/iawia002/lux/blob/master/app/app.go"
click node_registry "https://github.com/iawia002/lux/blob/master/app/register.go"
click node_extractor_api "https://github.com/iawia002/lux/blob/master/extractors/extractors.go"
click node_bilibili "https://github.com/iawia002/lux/blob/master/extractors/bilibili/bilibili.go"
click node_rumble "https://github.com/iawia002/lux/blob/master/extractors/rumble/rumble.go"
click node_weibo "https://github.com/iawia002/lux/blob/master/extractors/weibo/weibo.go"
click node_youku "https://github.com/iawia002/lux/blob/master/extractors/youku/youku.go"
click node_iqiyi "https://github.com/iawia002/lux/blob/master/extractors/iqiyi/iqiyi.go"
click node_qq "https://github.com/iawia002/lux/blob/master/extractors/qq/qq.go"
click node_site_extractors "https://github.com/iawia002/lux/tree/master/extractors"
click node_universal "https://github.com/iawia002/lux/blob/master/extractors/universal/universal.go"
click node_request "https://github.com/iawia002/lux/blob/master/request/request.go"
click node_parser "https://github.com/iawia002/lux/blob/master/parser/parser.go"
click node_media_utils "https://github.com/iawia002/lux/blob/master/utils/utils.go"
click node_downloader "https://github.com/iawia002/lux/blob/master/downloader/downloader.go"
click node_file_utils "https://github.com/iawia002/lux/blob/master/utils/download.go"
click node_ffmpeg "https://github.com/iawia002/lux/blob/master/utils/ffmpeg.go"

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_registry,node_user toneBlue
class node_extractor_api,node_bilibili,node_rumble,node_weibo,node_youku,node_iqiyi,node_qq,node_site_extractors,node_universal toneAmber
class node_request,node_parser,node_media_utils toneMint
class node_downloader,node_file_utils,node_ffmpeg,node_media_files toneRose
```

## Components

### CLI orchestration

- [CLI app](https://github.com/iawia002/lux/blob/master/app/app.go): `app/app.go`
- [Extractor registry](https://github.com/iawia002/lux/blob/master/app/register.go): `app/register.go`

### Extraction

- [Extractor API](https://github.com/iawia002/lux/blob/master/extractors/extractors.go): `extractors/extractors.go`
- [Bilibili](https://github.com/iawia002/lux/blob/master/extractors/bilibili/bilibili.go): `extractors/bilibili/bilibili.go`
- [Rumble](https://github.com/iawia002/lux/blob/master/extractors/rumble/rumble.go): `extractors/rumble/rumble.go`
- [Weibo](https://github.com/iawia002/lux/blob/master/extractors/weibo/weibo.go): `extractors/weibo/weibo.go`
- [Youku](https://github.com/iawia002/lux/blob/master/extractors/youku/youku.go): `extractors/youku/youku.go`
- [iQIYI](https://github.com/iawia002/lux/blob/master/extractors/iqiyi/iqiyi.go): `extractors/iqiyi/iqiyi.go`
- [QQ Video](https://github.com/iawia002/lux/blob/master/extractors/qq/qq.go): `extractors/qq/qq.go`
- [Other site extractors](https://github.com/iawia002/lux/tree/master/extractors): `extractors`
- [Direct resource](https://github.com/iawia002/lux/blob/master/extractors/universal/universal.go): `extractors/universal/universal.go`

### Network and media

- [HTTP requests](https://github.com/iawia002/lux/blob/master/request/request.go): `request/request.go`
- [Content parsing](https://github.com/iawia002/lux/blob/master/parser/parser.go): `parser/parser.go`
- [Media utilities](https://github.com/iawia002/lux/blob/master/utils/utils.go): `utils/utils.go`

### Download output

- [Stream downloader](https://github.com/iawia002/lux/blob/master/downloader/downloader.go): `downloader/downloader.go`
- [File operations](https://github.com/iawia002/lux/blob/master/utils/download.go): `utils/download.go`
- [FFmpeg processing](https://github.com/iawia002/lux/blob/master/utils/ffmpeg.go): `utils/ffmpeg.go`
- **Media files**

### Other components

- **User**

## Connections

- User → CLI app: supplies URLs
- CLI app → Extractor registry: dispatches extraction
- Extractor registry → Extractor API: selects handler
- Extractor API → Bilibili: extracts streams
- Extractor API → Rumble: extracts streams
- Extractor API → Weibo: extracts streams
- Extractor API → Youku: extracts streams
- Extractor API → iQIYI: extracts streams
- Extractor API → QQ Video: extracts streams
- Extractor API → Other site extractors: supports sites
- Extractor API → Direct resource: handles direct URLs
- CLI app → HTTP requests: sets options (evidence: `app/app.go`)
- Bilibili → HTTP requests: fetches metadata (evidence: `extractors/bilibili/bilibili.go`)
- Rumble → HTTP requests: fetches metadata
- Weibo → HTTP requests: fetches metadata (evidence: `extractors/weibo/weibo.go`)
- Youku → HTTP requests: fetches metadata
- iQIYI → HTTP requests: fetches metadata (evidence: `extractors/iqiyi/iqiyi.go`)
- QQ Video → HTTP requests: fetches metadata (evidence: `extractors/qq/qq.go`)
- Other site extractors → HTTP requests: fetches metadata
- Bilibili → Media utilities: parses media data
- iQIYI → Content parsing: parses page data
- Rumble → Media utilities: resolves playlists
- CLI app → Stream downloader: downloads extracted data (evidence: `app/app.go`)
- Stream downloader → HTTP requests: fetches stream parts (evidence: `downloader/downloader.go`)
- Stream downloader → File operations: uses file helpers
- Stream downloader → FFmpeg processing: embeds subtitles
- Stream downloader → Media files: writes media (evidence: `downloader/downloader.go`)
