Stream Description Scheme

June 22, 2026 ยท View on GitHub

For a stream to be approved, its description must follow this template:

#EXTINF:-1 tvg-id="STREAM_ID",STREAM_TITLE (QUALITY) [LABEL]
STREAM_URL
AttributeDescriptionRequiredValid values
STREAM_IDStream ID consisting of a channel ID and a feed ID. A full list of supported channels with corresponding IDs can be found on iptv-org.github.io.Optional<channel_id> or <channel_id>@<feed_id>
STREAM_TITLEStream title consisting of a channel name and a feed name. May contain any characters except ,, [, or ].Required-
QUALITYMaximum stream quality.Optional2160p, 1080p, 720p, 480p, 360p etc
LABELSpecified in cases where the broadcast for some reason may not be available to some users.OptionalGeo-blocked or Not 24/7
STREAM_URLStream URL. The following protocols are supported: HTTPS, HTTP, MMS, MMSH, RTSP, RTMP, SRT, RTP, UDP.Required-

Example:

#EXTINF:-1 tvg-id="ExampleTV.us@East",Example TV East (720p) [Geo-blocked]
https://example.com/playlist.m3u8

Also, if necessary, you can specify a custom HTTP User-Agent and HTTP Referrer through the #EXTVLCOPT directive:

#EXTINF:-1 tvg-id="ExampleTV.us",Example TV
#EXTVLCOPT:http-referrer=http://example.com/
#EXTVLCOPT:http-user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64)
http://example.com/stream.m3u8