# Guovin/iptv-api

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/guovin-iptv-api).**

22,563 stars · 7,158 forks · Python · mit

## Links

- GitHub: https://github.com/Guovin/iptv-api
- awesome-repositories: https://awesome-repositories.com/repository/guovin-iptv-api.md

## Topics

`auto-update` `awesome` `epg` `iptv` `iptv-api` `iptv-channels` `iptv-free` `iptv-m3u` `iptv-m3u8` `iptv-playlist` `ipv4` `ipv6` `live` `m3u` `m3u8` `playlist` `rtmp` `schedule` `tv` `tvbox`

## Description

This project is an automated service for managing and optimizing live television stream sources. It functions as an application programming interface that aggregates disparate media links, validates their availability through network probing, and organizes them into standardized playlist files. By integrating program guide data and channel logos, the system produces comprehensive, ready-to-use channel lists for third-party media players.

The service distinguishes itself through its background automation and media processing capabilities. It employs a modular pipeline to perform continuous, asynchronous updates, ensuring that broken or unreliable stream links are filtered out before they reach the end user. Additionally, the system includes a middleware layer that intercepts and transcodes live video feeds, normalizing protocols to improve playback stability and browser compatibility across varying network conditions.

The platform supports a range of deployment options, including containerized environments, to maintain consistent performance across different hardware and operating systems. The software is designed to handle the full lifecycle of media stream management, from initial ingestion and latency testing to the final generation of optimized, metadata-rich playlists.

## Tags

### Content Management & Publishing

- [IPTV & Live TV](https://awesome-repositories.com/f/content-management-publishing/media-management/iptv-live-tv.md) — Aggregates, validates, and optimizes live television channel lists into standardized playlist files.
- [Electronic Program Guides](https://awesome-repositories.com/f/content-management-publishing/media-management/electronic-program-guides.md) — Integrates broadcast schedule metadata and channel logos into standardized playlist files for a complete television viewing experience.

### Graphics & Multimedia

- [IPTV Playlist Generators](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/iptv-playlist-generators.md) — Aggregates, validates, and optimizes live stream sources into standardized M3U playlists with automated background updates.
- [Media Streaming](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming.md) — Monitors media source availability and performs latency tests to ensure reliable playback for end users.
- [Playlist Aggregators](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators.md) — Merges metadata, program guides, and verified stream addresses into common file formats for seamless integration.
- [Stream Source Validators](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/stream-source-validators.md) — Gathers live stream links, filters broken addresses, and performs speed tests to ensure reliable playback. ([source](https://cdn.jsdelivr.net/gh/Guovin/iptv-api@master/README.md))
- [Transcoders](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/transcoders.md) — Intercepts and transcodes live video feeds to improve playback compatibility within standard web browsers.
- [Video Streaming](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/video-streaming.md) — Monitors live video stream sources in the background to filter out broken links and ensure reliable playback.

### Repository Format

- [Awesome List](https://awesome-repositories.com/f/repository-format/awesome-list.md) — A community-curated directory that catalogs and links out to other open-source projects, rather than a standalone tool you run yourself.

### DevOps & Infrastructure

- [Media Proxy Services](https://awesome-repositories.com/f/devops-infrastructure/containerized-service-deployment/media-proxy-services.md) — Provides a deployable service that transcodes and serves live video feeds to improve compatibility and stability.
- [Automated Update Managers](https://awesome-repositories.com/f/devops-infrastructure/automated-update-managers.md) — Automates the refreshing of stream sources and playlist data without requiring manual user input. ([source](https://cdn.jsdelivr.net/gh/Guovin/iptv-api@master/README.md))

### Development Tools & Productivity

- [Media Source Validators](https://awesome-repositories.com/f/development-tools-productivity/webhook-configuration/endpoint-validation/media-source-validators.md) — Performs concurrent network probes and latency tests to filter out inactive or unreliable media links.

### Networking & Communication

- [Stream Proxies](https://awesome-repositories.com/f/networking-communication/stream-proxies.md) — Intercepts raw video feeds to normalize protocols and transcode content for improved browser compatibility.
- [Network Latency Analyzers](https://awesome-repositories.com/f/networking-communication/network-latency-analyzers.md) — Performs parallel latency tests and availability checks against remote endpoints to filter out unreliable media sources.

### Software Engineering & Architecture

- [Data Processing Pipelines](https://awesome-repositories.com/f/software-engineering-architecture/data-processing-pipelines.md) — Separates ingestion, verification, and transformation stages to allow independent scaling of the processing workflow.
- [Background Task Schedulers](https://awesome-repositories.com/f/software-engineering-architecture/execution-control/background-task-schedulers.md) — Executes periodic background routines to fetch, validate, and refresh media stream data automatically.