# soimort/you-get architecture

> Architecture diagram of the GitHub repository soimort/you-get, 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/soimort/you-get
- Repository: https://github.com/soimort/you-get

## Overview

You-Get is a command-line web media downloader. A user supplies a URL and options; the CLI hands off to shared extraction/download logic, which obtains site-specific stream information and downloads media, with optional stream merging or playback. The README also documents image scraping, arbitrary binary downloads, and JSON-style stream information. The graph shows the shared runtime layers and representative extractor subsystems rather than listing every site adapter. Some relationships are supported only by the SOURCE INDEX or README; unsampled dispatch details are not inferred.

Main entry points: [`src/you_get/common.py`](https://github.com/soimort/you-get/blob/develop/src/you_get/common.py) (Shared downloader), [`src/you_get/extractor.py`](https://github.com/soimort/you-get/blob/develop/src/you_get/extractor.py) (Extractor framework), [`src/you_get/extractors`](https://github.com/soimort/you-get/tree/develop/src/you_get/extractors) (Site adapters), [`src/you_get/extractors/bilibili.py`](https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/bilibili.py) (Bilibili adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command interface"]
  node_cli["CLI entry<br/>[__main__.py]"]
end

subgraph group_extract["Extraction"]
  node_framework["Extractor framework<br/>[extractor.py]"]
  node_site_adapters["Site adapters"]
  node_embed["Embedded media<br/>[embed.py]"]
  node_bilibili["Bilibili adapter<br/>[bilibili.py]"]
  node_youtube["YouTube adapter<br/>[youtube.py]"]
  node_youku["Youku adapter<br/>[youku.py]"]
end

subgraph group_transfer["Transfer and output"]
  node_shared["Shared downloader<br/>[common.py]"]
  node_json["JSON output<br/>[json_output.py]"]
end

subgraph group_media["Media processing"]
  node_ffmpeg["FFmpeg processing<br/>[ffmpeg.py]"]
  node_join_mp4["MP4 joining<br/>[join_mp4.py]"]
  node_join_flv["FLV joining<br/>[join_flv.py]"]
  node_player["Media player"]
end

node_user(("User"))
node_web{{"Media websites"}}

node_user -->|"supplies URL"| node_cli
node_cli -->|"invokes download"| node_shared
node_shared -.->|"selects extractor"| node_site_adapters
node_site_adapters -->|"uses framework"| node_framework
node_bilibili -->|"extends"| node_framework
node_bilibili -->|"fetches metadata"| node_shared
node_youtube -->|"uses download helpers"| node_shared
node_youku -->|"uses download helpers"| node_shared
node_embed -.->|"dispatches embeds"| node_site_adapters
node_framework -->|"downloads streams"| node_shared
node_shared -->|"emits stream data"| node_json
node_shared -->|"checks and merges"| node_ffmpeg
node_shared -->|"requests media"| node_web
node_shared -.->|"offers playback"| node_player
node_ffmpeg -.->|"supports joining"| node_join_mp4
node_shared -.->|"uses joiner"| node_join_flv

click node_cli "https://github.com/soimort/you-get/blob/develop/src/you_get/__main__.py"
click node_shared "https://github.com/soimort/you-get/blob/develop/src/you_get/common.py"
click node_framework "https://github.com/soimort/you-get/blob/develop/src/you_get/extractor.py"
click node_site_adapters "https://github.com/soimort/you-get/tree/develop/src/you_get/extractors"
click node_embed "https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/embed.py"
click node_bilibili "https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/bilibili.py"
click node_youtube "https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/youtube.py"
click node_youku "https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/youku.py"
click node_json "https://github.com/soimort/you-get/blob/develop/src/you_get/json_output.py"
click node_ffmpeg "https://github.com/soimort/you-get/blob/develop/src/you_get/processor/ffmpeg.py"
click node_join_mp4 "https://github.com/soimort/you-get/blob/develop/src/you_get/processor/join_mp4.py"
click node_join_flv "https://github.com/soimort/you-get/blob/develop/src/you_get/processor/join_flv.py"
click node_player "https://github.com/soimort/you-get/tree/develop/src/you_get/cli_wrapper/player"

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_user toneBlue
class node_framework,node_site_adapters,node_embed,node_bilibili,node_youtube,node_youku toneAmber
class node_shared,node_json toneMint
class node_ffmpeg,node_join_mp4,node_join_flv,node_player toneRose
class node_web toneIndigo
```

## Components

### Command interface

- [CLI entry](https://github.com/soimort/you-get/blob/develop/src/you_get/__main__.py): `src/you_get/__main__.py`

### Extraction

- [Extractor framework](https://github.com/soimort/you-get/blob/develop/src/you_get/extractor.py): `src/you_get/extractor.py`
- [Site adapters](https://github.com/soimort/you-get/tree/develop/src/you_get/extractors): `src/you_get/extractors`
- [Embedded media](https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/embed.py): `src/you_get/extractors/embed.py`
- [Bilibili adapter](https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/bilibili.py): `src/you_get/extractors/bilibili.py`
- [YouTube adapter](https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/youtube.py): `src/you_get/extractors/youtube.py`
- [Youku adapter](https://github.com/soimort/you-get/blob/develop/src/you_get/extractors/youku.py): `src/you_get/extractors/youku.py`

### Transfer and output

- [Shared downloader](https://github.com/soimort/you-get/blob/develop/src/you_get/common.py): `src/you_get/common.py`
- [JSON output](https://github.com/soimort/you-get/blob/develop/src/you_get/json_output.py): `src/you_get/json_output.py`

### Media processing

- [FFmpeg processing](https://github.com/soimort/you-get/blob/develop/src/you_get/processor/ffmpeg.py): `src/you_get/processor/ffmpeg.py`
- [MP4 joining](https://github.com/soimort/you-get/blob/develop/src/you_get/processor/join_mp4.py): `src/you_get/processor/join_mp4.py`
- [FLV joining](https://github.com/soimort/you-get/blob/develop/src/you_get/processor/join_flv.py): `src/you_get/processor/join_flv.py`
- [Media player](https://github.com/soimort/you-get/tree/develop/src/you_get/cli_wrapper/player): `src/you_get/cli_wrapper/player`

### Other components

- **User**
- **Media websites**

## Connections

- User → CLI entry: supplies URL
- CLI entry → Shared downloader: invokes download (evidence: `src/you_get/__main__.py`)
- Shared downloader → Site adapters: selects extractor (evidence: `src/you_get/extractors/bilibili.py`)
- Site adapters → Extractor framework: uses framework (evidence: `src/you_get/extractors/bilibili.py`)
- Bilibili adapter → Extractor framework: extends (evidence: `src/you_get/extractors/bilibili.py`)
- Bilibili adapter → Shared downloader: fetches metadata (evidence: `src/you_get/extractors/bilibili.py`)
- YouTube adapter → Shared downloader: uses download helpers (evidence: `src/you_get/extractors/youtube.py`)
- Youku adapter → Shared downloader: uses download helpers (evidence: `src/you_get/extractors/youku.py`)
- Embedded media → Site adapters: dispatches embeds (evidence: `src/you_get/extractors/embed.py`)
- Extractor framework → Shared downloader: downloads streams (evidence: `src/you_get/extractor.py`)
- Shared downloader → JSON output: emits stream data (evidence: `src/you_get/common.py`)
- Shared downloader → FFmpeg processing: checks and merges (evidence: `src/you_get/common.py`)
- Shared downloader → Media websites: requests media (evidence: `src/you_get/common.py`)
- Shared downloader → Media player: offers playback
- FFmpeg processing → MP4 joining: supports joining
- Shared downloader → FLV joining: uses joiner (evidence: `src/you_get/common.py`)
