# suxuang/myiptv architecture

> Architecture diagram of the GitHub repository suxuang/myiptv, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/suxuang/myiptv
- Repository: https://github.com/suxuang/myiptv

## Overview

##### Project type and purpose
- This is not a typical codebase but a static “content‐distribution” repository that collects, organizes, and serves IPTV live‐stream playlists (M3U/ TXT files) and their associated metadata (logos, EPG text).
- Its sole purpose is to maintain up-to-date playlists of TV channels, publish them via raw GitHub links/ proxies, and let end users subscribe via IPTV player apps.

##### File structure
– Top-level files:
- README.md: Project overview, subscription URLs, update log.
- *.m3u/*.txt in root: aggregated “master” playlists (ipv4.m3u, ipv6.m3u, tv.m3u, itv.m3u, etc.).
– back/ directory: source playlists by type and date (e.g., ipv4_*.m3u, ipv6_*.m3u, back/epg.txt for program guide).
– img/: auxiliary assets (channel logos, readme.txt with notes on image usage).
– player/: documentation for recommended players.
– tvlog/: miscellaneous logs or extra channel lists.
– Various stand-alone text files (咪咕点播.txt, 移动IPTV.m3u, etc.) for specialized subsets.

##### README for additional insights
– Explains manual update process, subscription URLs (GitHub raw + proxy), and recommended playback software.
– Emphasizes that content is static, updated by hand, and consumed by third-party apps.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Authoring & Control"
        Maintainer["Content Author (Maintainer)"]:::author
        GitHub["GitHub Repo"]:::vcs
    end

    subgraph "GitHub Repository"
        README["README.md"]
        IPv4["ipv4.m3u"]
        IPv6["ipv6.m3u"]
        TV["tv.m3u"]
        ITV["itv.m3u"]
        subgraph "back"
            EPG["epg.txt"]
            boxTV["boxTV.m3u"]
            ipv4hist["ipv4_0214.m3u ... ipv4全网通.m3u"]
            ipv6hist["ipv6.txt ... ipv6_20250204.m3u"]
        end
        subgraph "img"
            ImgReadme["readme.txt"]
        end
        subgraph "player"
            PlayerReadme["readme.txt"]
        end
        subgraph "tvlog"
            Logs["Misc Logs & Lists"]
        end
        MiGu["咪咕点播.txt"]
        MobileIPTV["移动IPTV.m3u"]
        MobileSpec["移动专享.txt"]
        Huya["虎牙影视.txt"]
    end

    subgraph "Distribution"
        CDN["CDN / Raw Proxy"]:::distribution
    end

    subgraph "Consumption"
        subgraph "End-User Devices"
            Player["IPTV Players (PotPlayer, TiviMate, APTV)"]:::client
        end
    end

    External["External Stream Sources"]:::external

    Maintainer -->|"git push"| GitHub
    GitHub -->|"replicate"| CDN
    Player -->|"HTTPS GET .m3u/.txt"| CDN
    Player -->|"HTTPS GET images/EPG"| CDN
    Player -->|"stream URLs from playlist"| External

    click README "https://github.com/suxuang/myiptv/blob/main//README.md"
    click IPv4 "https://github.com/suxuang/myiptv/blob/main//ipv4.m3u"
    click IPv6 "https://github.com/suxuang/myiptv/blob/main//ipv6.m3u"
    click TV "https://github.com/suxuang/myiptv/blob/main//tv.m3u"
    click ITV "https://github.com/suxuang/myiptv/blob/main//itv.m3u"
    click README "https://github.com/suxuang/myiptv/blob/main//README.md"
    click back "https://github.com/suxuang/myiptv/tree/main//back/"
    click EPG "https://github.com/suxuang/myiptv/blob/main//back/epg.txt"
    click boxTV "https://github.com/suxuang/myiptv/blob/main//back/boxTV.m3u"
    click ipv4hist "https://github.com/suxuang/myiptv/blob/main//back/ipv4_0214.m3u"
    click ipv6hist "https://github.com/suxuang/myiptv/blob/main//back/ipv6.txt"
    click ImgReadme "https://github.com/suxuang/myiptv/blob/main//img/readme.txt"
    click img "https://github.com/suxuang/myiptv/tree/main//img/"
    click PlayerReadme "https://github.com/suxuang/myiptv/blob/main//player/readme.txt"
    click player "https://github.com/suxuang/myiptv/tree/main//player/"
    click Logs "https://github.com/suxuang/myiptv/tree/main//tvlog/"
    click MiGu "https://github.com/suxuang/myiptv/blob/main//咪咕点播.txt"
    click MobileIPTV "https://github.com/suxuang/myiptv/blob/main//移动IPTV.m3u"
    click MobileSpec "https://github.com/suxuang/myiptv/blob/main//移动专享.txt"
    click Huya "https://github.com/suxuang/myiptv/blob/main//虎牙影视.txt"

    class Maintainer author
    class GitHub vcs
    classDef author fill:#bbdefb,stroke:#2196f3
    classDef vcs fill:#90caf9,stroke:#1976d2
    classDef distribution fill:#c8e6c9,stroke:#388e3c
    classDef client fill:#ffe0b2,stroke:#ef6c00
    classDef external fill:#e0e0e0,stroke:#757575
```
