Đường dẫn kiểu Xtream Codes

Nếu nhà cung cấp đưa cho bạn một máy chủ, một tên đăng nhập và một mật khẩu, hoặc một đường dẫn có get.php, thì dịch vụ đó dùng API kiểu Xtream Codes. Trang này giải thích các đường dẫn đó và cách dùng chúng trong TS IPTV.

TS IPTV không có sẵn kênh nào và không giới thiệu nhà cung cấp nào. Mọi ví dụ dùng máy chủ giả provider.example.com, tên đăng nhập U và mật khẩu P.

Đây là gì

“Xtream Codes” là tên một phần mềm quản lý (panel) mà nhiều nhà cung cấp IPTV dùng để quản lý thuê bao và luồng. Nó là API của nhà cung cấp, không phải định dạng tệp: máy chủ của nhà cung cấp tạo danh sách phát M3U, lịch XMLTV và dữ liệu JSON theo tài khoản của bạn. Không có đặc tả công khai chính thức; cấu trúc bên dưới là cấu trúc mà các trình phát mã nguồn mở vẫn dùng. Một nhà cung cấp có được cấp phép phát các kênh hay không là câu hỏi về chính nhà cung cấp đó, không phải về phần mềm họ dùng.

Đường dẫn chứa tên đăng nhập và mật khẩu của bạn. Đừng chia sẻ nó, đừng đăng nó lên mạng hay chụp màn hình có nó. Ai có đường dẫn là dùng được tài khoản của bạn.

Cấu trúc đường dẫn

http(s)://provider.example.com:8080 là máy chủ và cổng do nhà cung cấp đưa; U là tên đăng nhập, P là mật khẩu.

Mục đích	Đường dẫn
Danh sách phát M3U	`…/get.php?username=U&password=P&type=m3u_plus&output=ts` `type=m3u_plus`: có tên, logo, nhóm và `tvg-id`; `type=m3u`: không có. `output=ts` (MPEG-TS) hoặc `output=m3u8` (HLS).
Thông tin tài khoản (JSON)	`…/player_api.php?username=U&password=P` Trả về `user_info` (trạng thái, ngày hết hạn, số kết nối tối đa…) và `server_info`.
Danh mục và danh sách kênh (JSON)	`…/player_api.php?username=U&password=P&action=get_live_categories` `…&action=get_live_streams` (thêm `&category_id=X` để lọc)
Phim và phim bộ (JSON)	`…&action=get_vod_categories`, `get_vod_streams`, `get_vod_info&vod_id=X`, `get_series_categories`, `get_series`, `get_series_info&series_id=X`
Lịch phát sóng XMLTV	`…/xmltv.php?username=U&password=P`
Một kênh trực tiếp	`…/live/U/P/<stream_id>.ts` (hoặc `.m3u8`)
Một phim / một tập	`…/movie/U/P/<id>.<đuôi>`, `…/series/U/P/<id>.<đuôi>`
Xem lại (catch-up)	`…/timeshift/U/P/<số phút>/<YYYY-MM-DD:HH-MM>/<stream_id>.ts`

Ví dụ

Đây là đường dẫn danh sách phát bạn dán vào TS IPTV. Không có tệp để tải về: máy chủ của nhà cung cấp tạo danh sách theo tài khoản của bạn mỗi lần tải.

http://provider.example.com:8080/get.php?username=U&password=P&type=m3u_plus&output=ts

Nội dung trả về là một danh sách M3U bình thường. Một số nhà cung cấp thêm đường dẫn lịch vào dòng đầu, ví dụ #EXTM3U url-tvg="…/xmltv.php?username=U&password=P". Mỗi kênh trỏ tới một đường dẫn /live/U/P/….

Tự tạo

Không áp dụng: danh sách được máy chủ của nhà cung cấp tạo ra, bạn không viết nó.

Lưu trữ

Không áp dụng: nhà cung cấp lưu trữ danh sách, lịch và luồng trên máy chủ của họ.

Thêm vào TS IPTV

TS IPTV không có màn hình đăng nhập Xtream riêng. Bạn thêm tài khoản dưới dạng một đường dẫn danh sách phát:

Ghép đường dẫn: http(s)://<máy chủ>:<cổng>/get.php?username=U&password=P&type=m3u_plus&output=ts, thay máy chủ, cổng, U (tên đăng nhập) và P (mật khẩu) bằng thông tin nhà cung cấp đưa. Nhiều nhà cung cấp gửi sẵn đường dẫn này.
Mở Thêm nguồn IPTV, nhập Tên nguồn, dán đường dẫn vào Liên kết nguồn rồi chọn Thêm IPTV.
Lịch phát sóng: một số nhà cung cấp thêm url-tvg hoặc x-tvg-url trỏ tới xmltv.php vào danh sách, khi đó lịch được tải tự động. Nếu danh sách của bạn không có, TS IPTV hiện chưa có ô riêng cho đường dẫn lịch: hãy tải danh sách về, thêm x-tvg-url="…/xmltv.php?username=U&password=P" vào dòng #EXTM3U rồi dùng Nhập từ tệp (xem hướng dẫn XMLTV).

TS IPTV không gửi đường dẫn này tới dịch vụ phân tích.

Lỗi thường gặp

Lỗi	Biểu hiện	Cách sửa
Dùng `type=m3u`	Kênh không có nhóm, logo hay lịch	Dùng `type=m3u_plus`.
Dán đường dẫn `player_api.php`	Không nhận ra danh sách phát	Đó là API JSON, không phải danh sách phát; dùng `get.php`.
Sai cổng, hoặc `https` khi máy chủ chỉ có `http` (hay ngược lại)	Không kết nối được	Dùng đúng máy chủ, cổng và giao thức nhà cung cấp đưa.
Tài khoản hết hạn hoặc bị khoá	Danh sách trống, hoặc “Máy chủ từ chối luồng này”	Kiểm tra tài khoản với nhà cung cấp.
Vượt số kết nối cho phép (nhiều thiết bị cùng xem)	Kênh ngừng phát hoặc bị từ chối	Tắt phát trên thiết bị khác.
Kênh không phát trên iOS với `output=ts`	Lỗi khi phát	Thử `output=m3u8` (HLS).
Chia sẻ đường dẫn hoặc ảnh chụp màn hình có nó	Người khác dùng tài khoản của bạn	Đổi mật khẩu với nhà cung cấp.

TS IPTV hỗ trợ những gì

Tính năng	Trạng thái
Danh sách `get.php` (`m3u`, `m3u_plus`)	Hỗ trợ trên mọi nền tảng
Lịch `xmltv.php` qua `url-tvg`/`x-tvg-url` của danh sách	Hỗ trợ
Màn hình đăng nhập Xtream riêng (máy chủ, tên, mật khẩu)	Không có Dùng đường dẫn `get.php`.
Phim và phim bộ qua `player_api.php`	Không hỗ trợ Chỉ những mục có trong danh sách M3U.
Xem lại (`catchup="xc"`)	Được lưu, phát lại sẽ có sau

Xtream Codes style links

If your provider gave you a server, a username and a password, or a link that contains get.php, the service uses an Xtream Codes style API. This page explains those links and how to use them in TS IPTV.

TS IPTV includes no channels and recommends no provider. Every example uses the placeholder server provider.example.com, username U and password P.

What it is

“Xtream Codes” is the name of panel software that many IPTV providers use to manage subscribers and streams. It is a provider API, not a file format: the provider's server generates an M3U playlist, an XMLTV guide and JSON data for your account. There is no official public specification; the structure below is the one open-source players use. Whether a provider is licensed to carry its channels is a question about that provider, not about the software it runs.

The link contains your username and password. Do not share it, post it online or take screenshots that show it. Anyone who has the link can use your account.

URL structure

http(s)://provider.example.com:8080 is the server and port your provider gave you; U is the username, P the password.

Purpose	URL
M3U playlist	`…/get.php?username=U&password=P&type=m3u_plus&output=ts` `type=m3u_plus`: with names, logos, groups and `tvg-id`; `type=m3u`: without. `output=ts` (MPEG-TS) or `output=m3u8` (HLS).
Account information (JSON)	`…/player_api.php?username=U&password=P` Returns `user_info` (status, expiry date, maximum connections…) and `server_info`.
Categories and channel lists (JSON)	`…/player_api.php?username=U&password=P&action=get_live_categories` `…&action=get_live_streams` (add `&category_id=X` to filter)
Films and series (JSON)	`…&action=get_vod_categories`, `get_vod_streams`, `get_vod_info&vod_id=X`, `get_series_categories`, `get_series`, `get_series_info&series_id=X`
XMLTV guide	`…/xmltv.php?username=U&password=P`
One live channel	`…/live/U/P/<stream_id>.ts` (or `.m3u8`)
One film / one episode	`…/movie/U/P/<id>.<ext>`, `…/series/U/P/<id>.<ext>`
Catch-up	`…/timeshift/U/P/<minutes>/<YYYY-MM-DD:HH-MM>/<stream_id>.ts`

Example

This is the playlist link you paste into TS IPTV. There is no file to download: the provider's server generates the list for your account each time it is fetched.

http://provider.example.com:8080/get.php?username=U&password=P&type=m3u_plus&output=ts

What it returns is an ordinary M3U playlist. Some providers add a guide link to the first line, for example #EXTM3U url-tvg="…/xmltv.php?username=U&password=P". Each channel points to a /live/U/P/… link.

Create one

Not applicable: the provider's server generates the list; you do not write it.

Hosting

Not applicable: your provider hosts the list, the guide and the streams.

Add it in TS IPTV

TS IPTV has no separate Xtream login screen. You add the account as a playlist link:

Build the link: http(s)://<server>:<port>/get.php?username=U&password=P&type=m3u_plus&output=ts, replacing the server, the port, U (username) and P (password) with your provider's details. Many providers send this link ready-made.
Open Add IPTV Source, enter a Source Name, paste the link into Source Link and choose Add IPTV.
Programme guide: some providers add a url-tvg or x-tvg-url that points to xmltv.php, and then the guide loads automatically. If yours does not, TS IPTV has no separate guide URL field yet: download the list, add x-tvg-url="…/xmltv.php?username=U&password=P" to its #EXTM3U line and use Import from file (see the XMLTV guide).

TS IPTV does not send this link to analytics.

Common mistakes

Mistake	Symptom	Fix
Using `type=m3u`	Channels without groups, logos or guide	Use `type=m3u_plus`.
Pasting the `player_api.php` link	Not recognised as a playlist	That is a JSON API, not a playlist; use `get.php`.
Wrong port, or `https` when the server only speaks `http` (or the reverse)	Cannot connect	Use exactly the server, port and protocol your provider gave you.
The account has expired or is suspended	An empty list, or “The server refused this stream”	Check the account with your provider.
Too many connections (several devices watching)	Channels stop or are refused	Stop playback on the other device.
Channels do not play on iOS with `output=ts`	Playback error	Try `output=m3u8` (HLS).
Sharing the link, or a screenshot that shows it	Someone else uses your account	Change your password with the provider.

What TS IPTV supports

Feature	Status
`get.php` playlists (`m3u`, `m3u_plus`)	Supported on every platform
The `xmltv.php` guide through the list's `url-tvg`/`x-tvg-url`	Supported
A separate Xtream login screen (server, username, password)	Not available Use the `get.php` link.
Films and series through `player_api.php`	Not supported Only the entries in the M3U list.
Catch-up (`catchup="xc"`)	Stored, playback coming later

Đường dẫn kiểu Xtream Codes

Đây là gì

Cấu trúc đường dẫn

Ví dụ

Tự tạo

Lưu trữ

Thêm vào TS IPTV

Lỗi thường gặp

TS IPTV hỗ trợ những gì

Hướng dẫn liên quan

Xtream Codes style links

What it is

URL structure

Example

Create one

Hosting

Add it in TS IPTV

Common mistakes

What TS IPTV supports

Related guides