Danh sách phát M3U và M3U8

M3U là định dạng danh sách phát IPTV phổ biến nhất: một tệp văn bản thuần, mỗi kênh gồm một dòng mô tả và một dòng đường dẫn. Trang này trình bày cú pháp đầy đủ mà TS IPTV đọc được, kể cả các thuộc tính kiểu Kodi.

TS IPTV không có sẵn kênh nào. Ứng dụng chỉ phát các danh sách phát do bạn thêm vào. Mọi ví dụ dùng tên miền giả example.com, một luồng thử nghiệm công khai, hoặc tệp ví dụ của chính TS IPTV trên tsiptv-8bdd6.web.app.

M3U là gì

M3U ra đời cùng các trình nghe nhạc WinPlay3 và Winamp như một danh sách đường dẫn tới tệp media, mỗi dòng một đường dẫn. Cộng đồng IPTV mở rộng nó thành danh sách kênh: mỗi kênh có tên, logo, nhóm và mã để khớp với lịch phát sóng. Phần mở rộng này là quy ước chung, không phải một tiêu chuẩn chính thức.

Tên gọi	Nghĩa là gì
M3U	Danh sách đường dẫn thuần, mỗi dòng một mục, không có thông tin kèm theo.
M3U mở rộng	Dòng đầu là `#EXTM3U`, và mỗi mục có một dòng `#EXTINF` đứng trước.
M3U8	Cùng định dạng đó, nhưng mã hoá UTF-8. Phần mở rộng `.m3u8` báo hiệu UTF-8.

Danh sách HLS khác danh sách kênh IPTV

Luồng HLS cũng dùng tệp .m3u8 bắt đầu bằng #EXTM3U (RFC 8216), nhưng đó là chỉ mục của một luồng, không phải danh sách kênh:

	Danh sách media HLS	Danh sách kênh IPTV
Mỗi mục là	một đoạn video 2–10 giây của một luồng	một kênh (đường dẫn tới luồng của kênh đó)
`#EXTINF:<n>`	thời lượng đoạn, tính bằng giây	`-1` hoặc `0` (bỏ qua)
Thẻ đặc trưng	`#EXT-X-TARGETDURATION`, `#EXT-X-MEDIA-SEQUENCE`, `#EXT-X-STREAM-INF`	chỉ `#EXTM3U`
Thuộc tính trên `#EXTINF`	không có	`tvg-id="…"`, `group-title="…"` và các thuộc tính khác
Ai mở nó	trình phát video, tự động	bạn, khi thêm danh sách phát

Nếu bạn dán đường dẫn của một luồng HLS vào TS IPTV, ứng dụng nhận ra điều đó và hỏi “Đây là một luồng đơn”: chọn Thêm thành kênh để tạo một danh sách phát có đúng một kênh.

Cú pháp

#EXTM3U [thuộc tính tiêu đề]
#EXTINF:-1 [khoá="giá trị" ...],<Tên kênh>
[#EXTGRP:<nhóm>]
[#EXTVLCOPT:<tuỳ chọn>=<giá trị>]
[#KODIPROP:<thuộc tính>=<giá trị>]
<đường dẫn luồng>[|Header=Giá trị&Header=Giá trị]

Dòng đầu tiên là #EXTM3U. Mỗi kênh bắt đầu bằng một dòng #EXTINF, có thể có vài dòng tuỳ chọn, và kết thúc bằng dòng đường dẫn. Phần trong ngoặc vuông là không bắt buộc. Các dòng bắt đầu bằng # mà không phải thẻ đã biết được coi là chú thích.

Thuộc tính trên dòng `#EXTM3U`

Thuộc tính	Nghĩa
`x-tvg-url`	Đường dẫn lịch phát sóng XMLTV. Có thể ghi nhiều đường dẫn, cách nhau bằng dấu phẩy; TS IPTV tải tất cả (tối đa 5) và gộp lại.
`url-tvg`	Tên cũ của `x-tvg-url`. Chỉ được đọc khi không có `x-tvg-url`.
`tvg-shift`	Độ lệch giờ mặc định của lịch phát sóng, tính bằng giờ (ví dụ `+2`, `-4.5`), cho các kênh không tự khai báo.
`catchup`, `catchup-days`, `catchup-source`, `catchup-correction`	Giá trị xem lại mặc định cho các kênh không tự khai báo. Xem xem lại trong hướng dẫn Kodi.

Thuộc tính trên dòng `#EXTINF`

Mỗi thuộc tính có dạng khoá="giá trị", giá trị nằm trong dấu nháy kép thẳng. Tên thuộc tính không phân biệt hoa thường (tvg-ID được hiểu là tvg-id). Tất cả thuộc tính đứng trước dấu phẩy; tên kênh đứng sau.

Thuộc tính	Bắt buộc	Nghĩa
(tên sau dấu phẩy)	có	Tên hiển thị của kênh. Đó là phần chữ sau dấu phẩy đầu tiên nằm ngoài dấu nháy, nên tên có thể chứa dấu phẩy.
`tvg-id`	nên có	Mã để khớp kênh với `<channel id>` trong lịch XMLTV. Thường có dạng `TenKenh.ma-quoc-gia`, ví dụ `ExampleNews.us`.
`tvg-name`	không	Tên phụ, chỉ dùng để khớp với lịch phát sóng; không thay tên hiển thị.
`tvg-logo`	không	Đường dẫn ảnh logo (PNG, JPG hoặc SVG).
`group-title`	không	Nhóm của kênh. Nhiều nhóm cách nhau bằng dấu chấm phẩy: `group-title="News;HD"` đặt kênh vào cả hai nhóm.
`tvg-chno` (hoặc `ch-number`)	không	Số kênh, là số nguyên. Hiển thị trước tên kênh.
`tvg-shift`	không	Độ lệch giờ lịch phát sóng riêng cho kênh này, tính bằng giờ.
`radio`	không	`"true"` đánh dấu kênh radio: có biểu tượng radio và trình phát hiện logo thay cho khung video.
`media`	không	`"true"` đánh dấu một video theo yêu cầu thay vì kênh trực tiếp.
`catchup`, `catchup-days`, `catchup-source`, `catchup-correction`	không	Thông tin xem lại (catch-up). Được lưu lại; tính năng phát lại chương trình cũ sẽ có sau.
`user-agent`, `referrer`	không chuẩn	Một số công cụ ghi header ở dạng thuộc tính. TS IPTV vẫn đọc, nhưng nên dùng `#EXTVLCOPT` hoặc hậu tố `\|` bên dưới.

`#EXTGRP`

#EXTGRP:Tên nhóm là một cách khác để đặt nhóm, và có hai cách dùng:

Trong một kênh (sau #EXTINF, trước đường dẫn): áp dụng cho kênh đó nếu nó không có group-title.
Trước các kênh: trở thành nhóm mặc định cho mọi kênh phía sau không có group-title, cho tới một dòng #EXTGRP: để trống hoặc hết tệp.

`#EXTVLCOPT`

Dòng	Nghĩa
`#EXTVLCOPT:http-user-agent=…`	Header `User-Agent` cho luồng này.
`#EXTVLCOPT:http-referrer=…`	Header `Referer` cho luồng này (chú ý cách viết `referrer` có hai chữ r; `http-referer` cũng được chấp nhận).
khoá khác	Được lưu lại nhưng không có tác dụng.

Header sau dấu `|`

Bạn có thể gắn header HTTP ngay sau đường dẫn, theo kiểu Kodi: https://cdn.example.com/live.m3u8|User-Agent=Mozilla%2F5.0&Referer=https%3A%2F%2Fexample.com%2F.

TS IPTV tách ở dấu | đầu tiên: phần trước là đường dẫn luồng, phần sau là các cặp Tên=Giá trị nối bằng &.
Hãy mã hoá URL các giá trị (/ thành %2F, : thành %3A, dấu cách thành %20). Giá trị chưa mã hoá vẫn được chấp nhận nếu không chứa &.
Khi cùng một header được khai báo ở nhiều nơi, thứ tự ưu tiên là: hậu tố |, rồi #EXTVLCOPT, rồi #KODIPROP, rồi thuộc tính không chuẩn.

`#KODIPROP`

Các dòng #KODIPROP:khoá=giá trị đến từ Kodi. Chúng khai báo loại luồng (mimetype), header và DRM (Widevine, PlayReady, ClearKey). Chi tiết từng khoá và nền tảng hỗ trợ có trong hướng dẫn định dạng Kodi.

Ví dụ đầy đủ

Tệp dưới đây là tệp ví dụ của TS IPTV. Kênh đầu tiên phát thật (luồng thử nghiệm công khai của Mux, phim Big Buck Bunny © Blender Foundation, giấy phép CC BY 3.0); các kênh còn lại dùng đường dẫn giả example.com để minh hoạ cú pháp.

Tải playlist.m3u

#EXTM3U x-tvg-url="https://tsiptv-8bdd6.web.app/examples/guide.xml"
#EXTINF:-1 tvg-id="HlsTest.example" tvg-chno="1" group-title="Test",HLS Test Channel
https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8
#EXTINF:-1 tvg-id="ExampleNews.us" tvg-chno="2" tvg-logo="https://example.com/logos/news.png" group-title="News;HD",Example News
#EXTVLCOPT:http-user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64)
#EXTVLCOPT:http-referrer=https://example.com/
https://cdn.example.com/news/index.m3u8
#EXTINF:-1 tvg-id="ExampleSports.us" tvg-chno="3" group-title="Sports",Example Sports
https://cdn.example.com/sports/index.m3u8|Referer=https%3A%2F%2Fexample.com%2F
#EXTINF:-1 tvg-id="ExampleRadio.us" tvg-chno="4" radio="true" group-title="Radio",Example Radio
https://cdn.example.com/radio/stream.aac
#EXTINF:-1 tvg-id="ExampleProtected.us" tvg-chno="5" group-title="DRM demo",Example Protected
#KODIPROP:inputstream.adaptive.license_type=com.widevine.alpha
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|Content-Type=application%2Foctet-stream|R{SSM}|R
#KODIPROP:mimetype=application/dash+xml
https://cdn.example.com/protected/manifest.mpd
#EXTINF:-1 tvg-id="ExampleArchive.us" tvg-chno="6" catchup="shift" catchup-days="3" group-title="Archive",Example Archive
https://cdn.example.com/archive/index.m3u8

Giải thích từng phần:

Dòng 1: tiêu đề #EXTM3U, với x-tvg-url trỏ tới lịch phát sóng XMLTV ví dụ.
HLS Test Channel: kênh đơn giản nhất: một dòng #EXTINF với mã, số kênh và nhóm, rồi đến đường dẫn.
Example News: thuộc hai nhóm (News;HD), có logo, và gửi User-Agent cùng Referer qua hai dòng #EXTVLCOPT.
Example Sports: gửi Referer bằng hậu tố |, giá trị đã được mã hoá URL.
Example Radio: radio="true" đánh dấu kênh radio.
Example Protected: luồng DASH có DRM Widevine, khai báo bằng ba dòng #KODIPROP (xem hướng dẫn Kodi).
Example Archive: khai báo xem lại kiểu shift trong 3 ngày.

Danh sách phát nhỏ nhất hợp lệ chỉ có ba dòng:

#EXTM3U
#EXTINF:-1,Kênh của tôi
https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8

Nếu bạn chỉ có một luồng và muốn lưu nó thành tệp, bạn cũng có thể dùng tệp .strm: xem tệp .strm trong hướng dẫn Kodi.

Tự viết một tệp

Mở một trình soạn thảo văn bản thuần: Notepad (Windows), TextEdit ở chế độ văn bản thuần (macOS) hoặc VS Code. Đừng dùng Word hay Google Docs.
Gõ #EXTM3U ở dòng đầu tiên.
Với mỗi kênh, thêm hai dòng: #EXTINF:-1 <thuộc tính>,<Tên> rồi đến đường dẫn luồng.
Dùng dấu nháy kép thẳng " quanh giá trị thuộc tính, không dùng nháy cong “ ”.
Lưu với mã hoá UTF-8 (trong Notepad: Lưu thành › Mã hoá: UTF-8; tốt nhất là UTF-8 không có BOM), đuôi tệp .m3u hoặc .m3u8.
Thử từng đường dẫn luồng trước khi chia sẻ, ví dụ trong VLC: Media › Open Network Stream.

Đưa tệp lên mạng

Mọi đường dẫn trả về chính nội dung tệp đều dùng được. Máy chủ có thể gửi Content-Type là audio/x-mpegurl, application/vnd.apple.mpegurl hay text/plain; TS IPTV tự nhận dạng nội dung.

Cách	Dạng đường dẫn
GitHub (tệp gốc)	`https://raw.githubusercontent.com/<user>/<repo>/<branch>/playlist.m3u`
GitHub Pages	`https://<user>.github.io/<repo>/playlist.m3u`
Máy chủ tĩnh bất kỳ (Netlify, Cloudflare Pages, nginx của bạn…)	`https://www.example.com/playlist.m3u`
Dropbox	Đổi `dl=0` ở cuối đường dẫn chia sẻ thành `dl=1` để nhận tệp thay vì trang xem trước.
Tệp trên máy	Không cần đưa lên mạng: dùng Nhập từ tệp trong TS IPTV.

Không dùng được: trang chia sẻ của Google Drive hay OneDrive, trang xem trước của Dropbox (dl=0), và đường dẫn GitHub dạng github.com/<user>/<repo>/blob/…. Chúng trả về một trang web, không phải tệp. Hãy dùng đường dẫn tệp gốc (Raw) hoặc đường dẫn tải trực tiếp.

HTTPS được khuyến nghị. TS IPTV vẫn mở được http://, nhưng khi đó bất kỳ ai trên cùng mạng đều có thể đọc hoặc sửa tệp trên đường truyền.
CORS: TS IPTV là ứng dụng cài đặt, không cần header CORS. Chỉ thêm Access-Control-Allow-Origin: * nếu bạn muốn trình phát chạy trên web cũng đọc được tệp.
Danh sách phát từ đường dẫn được tải lại khi làm mới. Hãy giữ nguyên đường dẫn và sửa tệp tại chỗ.

Thêm vào TS IPTV

Trên điện thoại, máy tính bảng và máy tính

Mở Thêm nguồn IPTV (nút Thêm IPTV trên màn hình chính).
Nhập Tên nguồn, ví dụ “Kênh của tôi”.
Dán đường dẫn vào Liên kết nguồn rồi chọn Thêm IPTV. Hoặc chọn Nhập từ tệp và chọn tệp .m3u/.m3u8 trên máy (tối đa 20 MB).
Khi nhập xong, TS IPTV cho biết số kênh tìm thấy. Nếu có mục bị bỏ qua, bạn thấy thêm dòng “Không thể nhập N mục” và nút Chi tiết liệt kê lý do: cần tiện ích Kodi (plugin://), lấy luồng từ trang web, hoặc không có đường dẫn luồng.

Trên Android TV

Mở hộp thoại nhập danh sách phát, dùng các phím mũi tên để chuyển giữa tên, đường dẫn và nút thêm.
Nhập đường dẫn bằng bàn phím trên màn hình (hoặc bàn phím trên điện thoại nếu TV hỗ trợ).
Nhập từ tệp chỉ xuất hiện nếu TV có trình chọn tệp; phần lớn TV không có, nên hãy dùng đường dẫn.

Danh sách phát nhập từ tệp không tự làm mới: hãy nhập lại tệp khi bạn sửa nó.

Lỗi thường gặp

Lỗi	Biểu hiện	Cách sửa
Đầu tệp không phải `#EXTM3U` hay `#EXTINF` (ví dụ một trang HTML hoặc chữ khác)	Không nhận ra danh sách phát	Đặt `#EXTM3U` ở ngay đầu tệp.
Đường dẫn là một trang web (trang chia sẻ, `blob/` của GitHub)	“Đường dẫn này mở một trang web, không phải danh sách phát”	Dùng đường dẫn tệp gốc (raw) hoặc tải trực tiếp.
Nháy cong `“ ”` do trình soạn thảo văn bản tự đổi	Mất logo, mất nhóm	Gõ lại thành nháy thẳng `"`.
Không có dấu phẩy trước tên, hoặc thuộc tính đặt sau tên	Tên hiện ra như `tvg-id="…"`, hoặc không có tên	Viết `#EXTINF:-1 thuộc tính,Tên`; sau tên không còn gì.
Đường dẫn nằm cùng dòng với `#EXTINF`	Kênh không có luồng	Đường dẫn phải nằm trên dòng riêng.
Dấu cách hoặc `\|` trong đường dẫn chưa được mã hoá	Lỗi 404 hoặc 400	Mã hoá dấu cách thành `%20`; chỉ dùng `\|` cho phần header.
Header viết thành thuộc tính (`user-agent="…"`)	Máy chủ vẫn từ chối trên một số trình phát	Dùng `#EXTVLCOPT:http-user-agent=…` hoặc hậu tố `\|User-Agent=…`.
Lưu bằng ANSI/Windows-1252 khi tên có dấu	Tên bị lỗi font (`Ã©`)	Lưu lại bằng UTF-8.
`tvg-id` không trùng với `<channel id>` nào trong XMLTV	Không có lịch phát sóng	Chép mã y hệt, phân biệt hoa thường.
Nhập một luồng HLS như danh sách kênh	Hàng trăm “kênh” mang tên số đoạn	Chọn Thêm thành kênh trong hộp thoại luồng đơn, hoặc nhập danh sách kênh thật.
Đường dẫn có mã tạm thời (`?token=…`)	Hôm nay chạy, mai hỏng	Mã này hết hạn theo thiết kế; hãy lấy danh sách mới từ nhà cung cấp.
Mục `plugin://…`	Bị bỏ qua, ghi trong chi tiết nhập	Đây là tiện ích Kodi, không phải luồng; TS IPTV không chạy được. Xem hướng dẫn Kodi.

TS IPTV hỗ trợ những gì

Tính năng	Android	iOS	Máy tính
M3U, M3U mở rộng, M3U8, tệp nén gzip	Hỗ trợ	Hỗ trợ	Hỗ trợ
Nhiều nhóm, `#EXTGRP`, số kênh, kênh radio	Hỗ trợ	Hỗ trợ	Hỗ trợ
Nhiều lịch phát sóng trong `x-tvg-url`, `tvg-shift`	Hỗ trợ	Hỗ trợ	Hỗ trợ
Header theo kênh (`#EXTVLCOPT`, `\|`, `#KODIPROP`)	Mọi header	Cố gắng tối đa	Chỉ User-Agent và Referer
Luồng DASH `.mpd` không có DRM	Hỗ trợ	Hỗ trợ qua trình phát VLC tích hợp; chỉ gửi header User-Agent và Referer	Hỗ trợ
DRM (Widevine, PlayReady, ClearKey)	Chỉ Android	Không hỗ trợ	Không hỗ trợ
Xem lại (catch-up)	Được lưu, phát lại sẽ có sau
Luồng `rtmp`, `rtsp`, `udp`…	Được nhập nguyên vẹn; phát được hay không tuỳ trình phát của từng nền tảng.
Mục `plugin://` và `#WEBPROP`	Không hỗ trợ Bị bỏ qua và liệt kê trong chi tiết nhập.

M3U and M3U8 playlists

M3U is the most common IPTV playlist format: a plain text file where each channel is one description line and one link line. This page gives the full syntax TS IPTV reads, including the Kodi-style attributes.

TS IPTV includes no channels. It plays only the playlists you add. Every example uses example.com placeholders, a public test stream, or TS IPTV's own example files on tsiptv-8bdd6.web.app.

What M3U is

M3U started with the WinPlay3 and Winamp music players as a list of media locations, one per line. The IPTV community extended it into a channel list: each channel gets a name, a logo, a group and an identifier for the programme guide. These extensions are a shared convention, not a formal standard.

Name	What it is
M3U	A plain list of locations, one per line, with no metadata.
Extended M3U	The first line is `#EXTM3U`, and each entry is preceded by an `#EXTINF` line.
M3U8	The same format encoded as UTF-8. The `.m3u8` extension signals UTF-8.

HLS playlists are not IPTV channel lists

HLS streams also use .m3u8 files that start with #EXTM3U (RFC 8216), but those are the index of one stream, not a channel list:

	HLS media playlist	IPTV channel list
An entry is	a 2–10 second segment of one stream	a channel (a link to that channel's stream)
`#EXTINF:<n>`	segment duration in seconds	`-1` or `0` (ignored)
Typical tags	`#EXT-X-TARGETDURATION`, `#EXT-X-MEDIA-SEQUENCE`, `#EXT-X-STREAM-INF`	only `#EXTM3U`
Attributes on `#EXTINF`	none	`tvg-id="…"`, `group-title="…"` and others
Who opens it	the video player, automatically	you, when you add a playlist

If you paste the link of an HLS stream into TS IPTV, the app recognises it and asks “This is a single stream”: choose Add as channel to create a playlist with exactly one channel.

Syntax

#EXTM3U [header attributes]
#EXTINF:-1 [key="value" ...],<Channel name>
[#EXTGRP:<group>]
[#EXTVLCOPT:<option>=<value>]
[#KODIPROP:<property>=<value>]
<stream URL>[|Header=Value&Header=Value]

The first line is #EXTM3U. Each channel starts with an #EXTINF line, may have a few option lines, and ends with the link line. Parts in square brackets are optional. Lines that start with # but are not a known tag are comments.

Attributes on the `#EXTM3U` line

Attribute	Meaning
`x-tvg-url`	XMLTV guide URL. Several URLs may be separated by commas; TS IPTV downloads all of them (up to 5) and merges them.
`url-tvg`	Older name for `x-tvg-url`. Read only when `x-tvg-url` is absent.
`tvg-shift`	Default guide time shift in hours (for example `+2`, `-4.5`) for channels that do not set their own.
`catchup`, `catchup-days`, `catchup-source`, `catchup-correction`	Default catch-up values for channels that do not set their own. See catch-up in the Kodi guide.

Attributes on the `#EXTINF` line

Each attribute is key="value", with the value in straight double quotes. Attribute names are case-insensitive (tvg-ID is read as tvg-id). All attributes go before the comma; the channel name follows it.

Attribute	Required	Meaning
(name after the comma)	yes	The channel's display name: the text after the first comma that is outside quotes, so names may contain commas.
`tvg-id`	recommended	Identifier that links the channel to `<channel id>` in the XMLTV guide. Usually `ChannelName.country`, for example `ExampleNews.us`.
`tvg-name`	no	Alternative name used only for guide matching; it does not replace the display name.
`tvg-logo`	no	Logo image URL (PNG, JPG or SVG).
`group-title`	no	The channel's group. Separate several groups with semicolons: `group-title="News;HD"` puts the channel in both.
`tvg-chno` (or `ch-number`)	no	Channel number, an integer. Shown before the channel name.
`tvg-shift`	no	Guide time shift for this channel only, in hours.
`radio`	no	`"true"` marks a radio station: it gets a radio icon and the player shows its logo instead of a video area.
`media`	no	`"true"` marks an on-demand video instead of a live channel.
`catchup`, `catchup-days`, `catchup-source`, `catchup-correction`	no	Catch-up information. Stored; playback of past programmes comes later.
`user-agent`, `referrer`	non-standard	Some generators write headers as attributes. TS IPTV reads them, but prefer `#EXTVLCOPT` or the `\|` suffix below.

`#EXTGRP`

#EXTGRP:Group name is another way to set a group, and it works two ways:

Inside a channel (after #EXTINF, before the link): applies to that channel if it has no group-title.
Before channels: becomes the default group for every following channel without a group-title, until an empty #EXTGRP: line or the end of the file.

`#EXTVLCOPT`

Line	Meaning
`#EXTVLCOPT:http-user-agent=…`	`User-Agent` header for this stream.
`#EXTVLCOPT:http-referrer=…`	`Referer` header for this stream (note the spelling `referrer` with two r's; `http-referer` is accepted too).
other keys	Stored, no effect.

Headers after `|`

You can attach HTTP headers right after the link, Kodi style: https://cdn.example.com/live.m3u8|User-Agent=Mozilla%2F5.0&Referer=https%3A%2F%2Fexample.com%2F.

TS IPTV splits at the first |: the left part is the stream URL, the right part is Name=Value pairs joined with &.
URL-encode the values (/ becomes %2F, : becomes %3A, a space becomes %20). Unencoded values are accepted as long as they contain no &.
When the same header is set in several places, the order of priority is: the | suffix, then #EXTVLCOPT, then #KODIPROP, then non-standard attributes.

`#KODIPROP`

#KODIPROP:key=value lines come from Kodi. They declare the stream type (mimetype), headers and DRM (Widevine, PlayReady, ClearKey). Each key and its platform support is described in the Kodi formats guide.

Complete example

This is TS IPTV's example file. The first channel really plays (the Mux public test stream, Big Buck Bunny © Blender Foundation, licensed CC BY 3.0); the other channels use example.com placeholders to show the syntax.

Download playlist.m3u

#EXTM3U x-tvg-url="https://tsiptv-8bdd6.web.app/examples/guide.xml"
#EXTINF:-1 tvg-id="HlsTest.example" tvg-chno="1" group-title="Test",HLS Test Channel
https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8
#EXTINF:-1 tvg-id="ExampleNews.us" tvg-chno="2" tvg-logo="https://example.com/logos/news.png" group-title="News;HD",Example News
#EXTVLCOPT:http-user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64)
#EXTVLCOPT:http-referrer=https://example.com/
https://cdn.example.com/news/index.m3u8
#EXTINF:-1 tvg-id="ExampleSports.us" tvg-chno="3" group-title="Sports",Example Sports
https://cdn.example.com/sports/index.m3u8|Referer=https%3A%2F%2Fexample.com%2F
#EXTINF:-1 tvg-id="ExampleRadio.us" tvg-chno="4" radio="true" group-title="Radio",Example Radio
https://cdn.example.com/radio/stream.aac
#EXTINF:-1 tvg-id="ExampleProtected.us" tvg-chno="5" group-title="DRM demo",Example Protected
#KODIPROP:inputstream.adaptive.license_type=com.widevine.alpha
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|Content-Type=application%2Foctet-stream|R{SSM}|R
#KODIPROP:mimetype=application/dash+xml
https://cdn.example.com/protected/manifest.mpd
#EXTINF:-1 tvg-id="ExampleArchive.us" tvg-chno="6" catchup="shift" catchup-days="3" group-title="Archive",Example Archive
https://cdn.example.com/archive/index.m3u8

Part by part:

Line 1: the #EXTM3U header, with x-tvg-url pointing to the example XMLTV guide.
HLS Test Channel: the simplest channel: one #EXTINF line with an id, a number and a group, then the link.
Example News: in two groups (News;HD), with a logo, sending User-Agent and Referer through two #EXTVLCOPT lines.
Example Sports: sends Referer with the | suffix, URL-encoded.
Example Radio: radio="true" marks a radio station.
Example Protected: a Widevine-protected DASH stream, declared with three #KODIPROP lines (see the Kodi guide).
Example Archive: declares shift catch-up for 3 days.

The smallest valid playlist has three lines:

#EXTM3U
#EXTINF:-1,My Channel
https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8

If you have a single stream and want to keep it as a file, you can also use a .strm file: see .strm files in the Kodi guide.

Create one by hand

Open a plain-text editor: Notepad (Windows), TextEdit in plain text mode (macOS) or VS Code. Do not use Word or Google Docs.
Type #EXTM3U on the first line.
For each channel, add two lines: #EXTINF:-1 <attributes>,<Name> and then the stream URL.
Use straight double quotes " around attribute values, not curly quotes “ ”.
Save as UTF-8 (in Notepad: Save as › Encoding: UTF-8; UTF-8 without BOM is best), with the extension .m3u or .m3u8.
Test each stream URL before you share the file, for example in VLC: Media › Open Network Stream.

Host it

Any link that returns the file itself works. The server may send Content-Type audio/x-mpegurl, application/vnd.apple.mpegurl or text/plain; TS IPTV detects the content.

Option	URL shape
GitHub (raw file)	`https://raw.githubusercontent.com/<user>/<repo>/<branch>/playlist.m3u`
GitHub Pages	`https://<user>.github.io/<repo>/playlist.m3u`
Any static host (Netlify, Cloudflare Pages, your own nginx…)	`https://www.example.com/playlist.m3u`
Dropbox	Change `dl=0` at the end of the share link to `dl=1` so it returns the file, not a preview page.
A file on your device	No hosting needed: use Import from file in TS IPTV.

What does not work: Google Drive or OneDrive share pages, Dropbox preview links (dl=0), and GitHub links of the form github.com/<user>/<repo>/blob/…. They return a web page, not the file. Use the Raw or direct-download link instead.

HTTPS is recommended. TS IPTV also opens http:// links, but then anyone on the network path can read or change the file.
CORS: TS IPTV is an installed app and needs no CORS headers. Add Access-Control-Allow-Origin: * only if web-based players should read the file too.
Playlists added by link are downloaded again when you refresh. Keep the URL stable and edit the file in place.

Add it in TS IPTV

On phones, tablets and desktop

Open Add IPTV Source (the Add IPTV button on the home screen).
Enter a Source Name, for example “My channels”.
Paste the link into Source Link and choose Add IPTV. Or choose Import from file and pick an .m3u/.m3u8 file on your device (up to 20 MB).
When the import finishes, TS IPTV shows how many channels it found. If entries were skipped, you also see “N entries could not be imported” and a Details button listing the reasons: a Kodi add-on is needed (plugin://), web-page scraping, or no stream link.

On Android TV

Open the import dialog and use the arrow keys to move between the name, the link and the add button.
Type the link with the on-screen keyboard (or your phone's keyboard, if your TV supports it).
Import from file appears only if the TV has a file picker; most TVs do not, so use a link.

Playlists imported from a file do not refresh on their own: import the file again after you edit it.

Common mistakes

Mistake	Symptom	Fix
Something other than `#EXTM3U`/`#EXTINF` at the start (an HTML page, other text)	Not recognised as a playlist	Make `#EXTM3U` the very start of the file.
The link is a web page (a share page, a GitHub `blob/` URL)	“This link opens a web page, not a playlist”	Use the raw or direct-download link.
Curly quotes `“ ”` inserted by a word processor	Logos and groups missing	Retype them as straight `"`.
No comma before the name, or attributes after the name	The name shows as `tvg-id="…"`, or there is no name	Write `#EXTINF:-1 attributes,Name`; nothing after the name.
The link is on the same line as `#EXTINF`	The channel has no stream	The link goes on its own line.
Unencoded space or `\|` in the link	404 or 400 errors	Encode spaces as `%20`; use `\|` only for the header suffix.
Headers written as attributes (`user-agent="…"`)	The server still refuses on some players	Use `#EXTVLCOPT:http-user-agent=…` or the `\|User-Agent=…` suffix.
Saved as ANSI/Windows-1252 with accented names	Garbled names (`Ã©`)	Save again as UTF-8.
`tvg-id` matches no XMLTV `<channel id>`	No programme guide	Copy ids exactly; they are case-sensitive.
An HLS stream imported as a channel list	Hundreds of “channels” named after segment numbers	Choose Add as channel in the single-stream dialog, or import the real channel list.
Links with temporary tokens (`?token=…`)	Works today, fails tomorrow	Tokens expire by design; get a fresh list from your provider.
`plugin://…` entries	Skipped, listed in the import details	These are Kodi add-ons, not streams; TS IPTV cannot run them. See the Kodi guide.

What TS IPTV supports

Feature	Android	iOS	Desktop
M3U, extended M3U, M3U8, gzip-compressed files	Supported	Supported	Supported
Several groups, `#EXTGRP`, channel numbers, radio	Supported	Supported	Supported
Several guides in `x-tvg-url`, `tvg-shift`	Supported	Supported	Supported
Per-channel headers (`#EXTVLCOPT`, `\|`, `#KODIPROP`)	All headers	Best effort	User-Agent and Referer only
DASH `.mpd` streams without DRM	Supported	Supported through the built-in VLC player; only the User-Agent and Referer headers are sent	Supported
DRM (Widevine, PlayReady, ClearKey)	Android only	Not supported	Not supported
Catch-up	Stored, playback coming later
`rtmp`, `rtsp`, `udp`… streams	Imported unchanged; whether they play depends on each platform's player.
`plugin://` and `#WEBPROP` entries	Not supported Skipped and listed in the import details.

Danh sách phát M3U và M3U8

M3U là gì

Danh sách HLS khác danh sách kênh IPTV

Cú pháp

Thuộc tính trên dòng #EXTM3U

Thuộc tính trên dòng #EXTINF

#EXTGRP

#EXTVLCOPT

Header sau dấu |

#KODIPROP

Ví dụ đầy đủ

Tự viết một tệp

Đưa tệp lên mạng

Thêm vào TS IPTV

Trên điện thoại, máy tính bảng và máy tính

Trên Android TV

Lỗi thường gặp

TS IPTV hỗ trợ những gì

Hướng dẫn liên quan

M3U and M3U8 playlists

What M3U is

HLS playlists are not IPTV channel lists

Syntax

Attributes on the #EXTM3U line

Attributes on the #EXTINF line

#EXTGRP

#EXTVLCOPT

Headers after |

#KODIPROP

Complete example

Create one by hand

Host it

Add it in TS IPTV

On phones, tablets and desktop

On Android TV

Common mistakes

What TS IPTV supports

Related guides

Thuộc tính trên dòng `#EXTM3U`

Thuộc tính trên dòng `#EXTINF`

`#EXTGRP`

`#EXTVLCOPT`

Header sau dấu `|`

`#KODIPROP`

Attributes on the `#EXTM3U` line

Attributes on the `#EXTINF` line

`#EXTGRP`

`#EXTVLCOPT`

Headers after `|`

`#KODIPROP`