# iptv-org/awesome-iptv architecture

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

- Interactive diagram: https://gitdiagram.com/iptv-org/awesome-iptv
- Repository: https://github.com/iptv-org/awesome-iptv

## Overview

Awesome IPTV is a curated directory, not a software runtime: readers discover IPTV providers, players, tools, and datasets through category links to GitHub Discussions. Contributors submit a proposed link through the issue form; after review, it is published in the appropriate Discussions category. The repository evidence is limited to the README and file tree, so the graph shows only those documented relationships.

Main entry points: [`README.md`](https://github.com/iptv-org/awesome-iptv/blob/master/README.md) (Curated catalog), [`.github/ISSUE_TEMPLATE/new_link.yml`](https://github.com/iptv-org/awesome-iptv/blob/master/.github/ISSUE_TEMPLATE/new_link.yml) (Link form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Resource discovery"]
  node_catalog["Curated catalog<br/>[README.md]"]
  node_providers["Providers"]
  node_players["Players"]
  node_tools["Tools"]
  node_datasets["Datasets"]
end

subgraph group_contribution["Link contributions"]
  node_submission["Link form<br/>[new_link.yml]"]
end

node_reader(("Reader"))
node_contributor(("Contributor"))
node_reviewer(("Reviewer"))

node_reader -->|"browses"| node_catalog
node_catalog -->|"links to"| node_providers
node_catalog -->|"links to"| node_players
node_catalog -->|"links to"| node_tools
node_catalog -->|"links to"| node_datasets
node_contributor -->|"fills out"| node_submission
node_submission -->|"undergoes review"| node_reviewer
node_reviewer -->|"publishes in"| node_providers
node_reviewer -->|"publishes in"| node_players
node_reviewer -->|"publishes in"| node_tools
node_reviewer -->|"publishes in"| node_datasets

click node_catalog "https://github.com/iptv-org/awesome-iptv/blob/master/README.md"
click node_submission "https://github.com/iptv-org/awesome-iptv/blob/master/.github/ISSUE_TEMPLATE/new_link.yml"

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_catalog,node_providers,node_players,node_tools,node_datasets,node_reviewer toneBlue
class node_submission toneAmber
class node_reader,node_contributor toneIndigo
```

## Components

### Resource discovery

- [Curated catalog](https://github.com/iptv-org/awesome-iptv/blob/master/README.md): `README.md`
- **Providers**
- **Players**
- **Tools**
- **Datasets**

### Link contributions

- [Link form](https://github.com/iptv-org/awesome-iptv/blob/master/.github/ISSUE_TEMPLATE/new_link.yml): `.github/ISSUE_TEMPLATE/new_link.yml`

### Other components

- **Reader**
- **Contributor**
- **Reviewer**

## Connections

- Reader → Curated catalog: browses (evidence: `README.md`)
- Curated catalog → Providers: links to (evidence: `README.md`)
- Curated catalog → Players: links to (evidence: `README.md`)
- Curated catalog → Tools: links to (evidence: `README.md`)
- Curated catalog → Datasets: links to (evidence: `README.md`)
- Contributor → Link form: fills out (evidence: `README.md`)
- Link form → Reviewer: undergoes review (evidence: `README.md`)
- Reviewer → Providers: publishes in (evidence: `README.md`)
- Reviewer → Players: publishes in (evidence: `README.md`)
- Reviewer → Tools: publishes in (evidence: `README.md`)
- Reviewer → Datasets: publishes in (evidence: `README.md`)
