Danh sách phát XSPF

XSPF (XML Shareable Playlist Format, đọc là “spiff”) là định dạng danh sách phát dạng XML. VLC dùng nó để lưu danh sách phát, kể cả danh sách kênh IPTV.

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.

XSPF là gì

XSPF là một định dạng mở, được mô tả trong đặc tả XSPF phiên bản 1. Mỗi mục là một <track> với đường dẫn, tiêu đề và ảnh. So với M3U, XSPF dài hơn nhưng có cấu trúc chặt chẽ; bạn thường gặp nó khi lưu danh sách từ VLC.

Cú pháp

<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
  <title>…</title>                 (0 hoặc 1)
  <trackList>                     (đúng 1, có thể rỗng)
    <track>
      <location>URI</location>    (0 hoặc nhiều; chỉ một được phát)
      <title>…</title>             (0 hoặc 1)
      <image>URI</image>          (0 hoặc 1)
      <extension application="URI">…</extension>
    </track>
  </trackList>
</playlist>

Không gian tên (namespace) là http://xspf.org/ns/0/ và version="1": không gian tên mang số 0 nhưng phiên bản là 1.
Phần tử tuỳ chọn ở cấp danh sách: title, creator, annotation, info, location, identifier, image, date, license, attribution, link, meta, extension.
Phần tử tuỳ chọn ở cấp track: location, identifier, title, creator, annotation, info, image, album, trackNum, duration (mili giây, chỉ mang tính gợi ý), link, meta, extension.
Đường dẫn tương đối được tính theo địa chỉ của chính tệp XSPF.

Phần mở rộng của VLC

VLC thêm thông tin riêng trong <extension application="http://www.videolan.org/vlc/playlist/0">, với không gian tên xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/":

Phần tử	Ở đâu	Nghĩa
`<vlc:id>`	trong `<extension>` của mỗi track	Số thứ tự của track. TS IPTV dùng nó làm mã kênh.
`<vlc:node title="…">`	trong `<extension>` cấp danh sách	Một nhóm (thư mục).
`<vlc:item tid="N"/>`	trong `<vlc:node>`	Track có `vlc:id` bằng N thuộc nhóm này.
`<vlc:option>`	trong `<extension>` của track	Tuỳ chọn phát của VLC. TS IPTV bỏ qua.

Ví dụ đầy đủ

Track đầu tiên là luồng thử nghiệm công khai của Mux (Big Buck Bunny © Blender Foundation, CC BY 3.0); track thứ hai dùng đường dẫn giả example.com.

Tải playlist.xspf

<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
  <title>TS IPTV example playlist</title>
  <trackList>
    <track>
      <location>https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8</location>
      <title>HLS Test Channel</title>
      <extension application="http://www.videolan.org/vlc/playlist/0">
        <vlc:id>0</vlc:id>
      </extension>
    </track>
    <track>
      <location>https://cdn.example.com/news/index.m3u8</location>
      <title>Example News</title>
      <image>https://example.com/logos/news.png</image>
      <extension application="http://www.videolan.org/vlc/playlist/0">
        <vlc:id>1</vlc:id>
      </extension>
    </track>
  </trackList>
  <extension application="http://www.videolan.org/vlc/playlist/0">
    <vlc:node title="Test"><vlc:item tid="0"/></vlc:node>
    <vlc:node title="News"><vlc:item tid="1"/></vlc:node>
  </extension>
</playlist>

Dòng 2 khai báo cả không gian tên XSPF và không gian tên VLC.
<title> đầu tiên là tên danh sách phát.
Mỗi <track> có <location> (đường dẫn luồng), <title> (tên kênh), có thể có <image> (logo), và <vlc:id>.
<extension> cuối tệp chia track vào các nhóm “Test” và “News”.

Giữ mỗi phần tử trên một dòng. Trình đọc XSPF hiện tại của TS IPTV đọc từng dòng, nên <location>…</location>, <title>…</title> và <vlc:id>…</vlc:id> phải nằm gọn trên một dòng như trong ví dụ. VLC cũng lưu tệp theo cách này.

Tạo một tệp

Bằng VLC

Mở các luồng trong VLC (Media › Open Network Stream) để chúng vào danh sách phát.
Chọn Media › Save Playlist to File….
Chọn định dạng XSPF và lưu với đuôi .xspf.

Bằng tay

Chép ví dụ ở trên vào một trình soạn thảo văn bản thuần.
Thêm hoặc sửa các <track>, mỗi phần tử một dòng.
Viết & trong đường dẫn thành &.
Lưu với mã hoá UTF-8, đuôi .xspf.

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

Giống như M3U: mọi đường dẫn HTTPS trả về chính nội dung tệp đều dùng được (https://raw.githubusercontent.com/<user>/<repo>/<branch>/playlist.xspf, https://<user>.github.io/<repo>/playlist.xspf, https://www.example.com/playlist.xspf, Dropbox với dl=1). Trang chia sẻ và đường dẫn blob/ của GitHub không dùng được. HTTPS được khuyến nghị; TS IPTV không cần CORS. Máy chủ có thể gửi Content-Type: application/xspf+xml hoặc text/xml. Chi tiết: đưa tệp M3U lên mạng.

Thêm vào TS IPTV

Mở Thêm nguồn IPTV (nút Thêm 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; hoặc chọn Nhập từ tệp và chọn tệp .xspf.
TS IPTV nhận ra XSPF qua dòng đầu <?xml …?> và không gian tên và cho biết số kênh tìm thấy. Trên TV, dùng đường dẫn nếu TV không có trình chọn tệp.

Lỗi thường gặp

Lỗi	Biểu hiện	Cách sửa
Thiếu dòng đầu `<?xml version="1.0" encoding="UTF-8"?>`	Không nhận ra danh sách phát	Đặt dòng này ở ngay đầu tệp; hiện TS IPTV cần nó để nhận dạng XSPF.
Thiếu hoặc sai `xmlns`	Không nhận ra danh sách phát	Dùng đúng `xmlns="http://xspf.org/ns/0/"`.
`&` trong đường dẫn chưa viết thành `&`	Lỗi đọc XML	Viết `&`.
Đường dẫn đặt trong `<title>` hoặc `<info>`	Track không phát được	Đặt đường dẫn luồng trong `<location>`.
Một phần tử bị ngắt thành nhiều dòng	Mất tên hoặc mất đường dẫn	Giữ mỗi phần tử trên một dòng.
Track không có `<title>`	Track bị bỏ qua	Mỗi track cần cả `<location>` và `<title>`.
Dựa vào `<duration>` cho kênh trực tiếp	Không có tác dụng	Bỏ `<duration>` với luồng trực tiếp.

TS IPTV hỗ trợ những gì

Tính năng	Trạng thái
`location`, `title`, `image` của track	Hỗ trợ trên mọi nền tảng
`vlc:id` làm mã kênh	Hỗ trợ
Nhóm từ `vlc:node`	Một phần Tên nhóm được đọc, nhưng track chưa được gán vào nhóm theo `vlc:item tid`.
Phần tử viết trên nhiều dòng	Không hỗ trợ Giữ mỗi phần tử trên một dòng.
Header, DRM, lịch phát sóng	Không có trong XSPF Dùng M3U nếu cần.

XSPF playlists

XSPF (XML Shareable Playlist Format, pronounced “spiff”) is an XML playlist format. VLC uses it to save playlists, including IPTV channel lists.

TS IPTV includes no channels. It plays only the playlists you add.

What XSPF is

XSPF is an open format defined by the XSPF version 1 specification. Each entry is a <track> with a location, a title and an image. It is more verbose than M3U but strictly structured; you usually meet it when you save a list from VLC.

Syntax

<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
  <title>…</title>                 (0 or 1)
  <trackList>                     (exactly 1, may be empty)
    <track>
      <location>URI</location>    (0 or more; only one is played)
      <title>…</title>             (0 or 1)
      <image>URI</image>          (0 or 1)
      <extension application="URI">…</extension>
    </track>
  </trackList>
</playlist>

The namespace is http://xspf.org/ns/0/ with version="1": the namespace says 0 but the version is 1.
Optional playlist-level elements: title, creator, annotation, info, location, identifier, image, date, license, attribution, link, meta, extension.
Optional track-level elements: location, identifier, title, creator, annotation, info, image, album, trackNum, duration (milliseconds, a hint only), link, meta, extension.
Relative locations are resolved against the address of the XSPF file itself.

VLC's extension

VLC adds its own information inside <extension application="http://www.videolan.org/vlc/playlist/0">, with the namespace xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/":

Element	Where	Meaning
`<vlc:id>`	in each track's `<extension>`	The track's number. TS IPTV uses it as the channel id.
`<vlc:node title="…">`	in the playlist-level `<extension>`	A group (folder).
`<vlc:item tid="N"/>`	inside `<vlc:node>`	The track whose `vlc:id` is N belongs to this group.
`<vlc:option>`	in a track's `<extension>`	A VLC playback option. TS IPTV ignores it.

Complete example

The first track is the Mux public test stream (Big Buck Bunny © Blender Foundation, CC BY 3.0); the second uses an example.com placeholder.

Download playlist.xspf

<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
  <title>TS IPTV example playlist</title>
  <trackList>
    <track>
      <location>https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8</location>
      <title>HLS Test Channel</title>
      <extension application="http://www.videolan.org/vlc/playlist/0">
        <vlc:id>0</vlc:id>
      </extension>
    </track>
    <track>
      <location>https://cdn.example.com/news/index.m3u8</location>
      <title>Example News</title>
      <image>https://example.com/logos/news.png</image>
      <extension application="http://www.videolan.org/vlc/playlist/0">
        <vlc:id>1</vlc:id>
      </extension>
    </track>
  </trackList>
  <extension application="http://www.videolan.org/vlc/playlist/0">
    <vlc:node title="Test"><vlc:item tid="0"/></vlc:node>
    <vlc:node title="News"><vlc:item tid="1"/></vlc:node>
  </extension>
</playlist>

Line 2 declares both the XSPF namespace and the VLC namespace.
The first <title> is the playlist name.
Each <track> has a <location> (the stream URL), a <title> (the channel name), optionally an <image> (the logo), and a <vlc:id>.
The <extension> at the end puts the tracks in the groups “Test” and “News”.

Keep one element per line. TS IPTV's current XSPF reader works line by line, so <location>…</location>, <title>…</title> and <vlc:id>…</vlc:id> must each fit on one line, as in the example. VLC saves files this way too.

Create one

With VLC

Open the streams in VLC (Media › Open Network Stream) so they are in its playlist.
Choose Media › Save Playlist to File….
Pick the XSPF format and save with the extension .xspf.

By hand

Copy the example above into a plain-text editor.
Add or edit <track> elements, one element per line.
Write & in URLs as &.
Save as UTF-8 with the extension .xspf.

Host it

Just like M3U: any HTTPS link that returns the file itself works (https://raw.githubusercontent.com/<user>/<repo>/<branch>/playlist.xspf, https://<user>.github.io/<repo>/playlist.xspf, https://www.example.com/playlist.xspf, Dropbox with dl=1). Share pages and GitHub blob/ links do not work. HTTPS is recommended; TS IPTV needs no CORS. The server may send Content-Type: application/xspf+xml or text/xml. Details: hosting an M3U file.

Add it in TS IPTV

Open Add IPTV Source (the Add IPTV button).
Enter a Source Name, paste the link into Source Link and choose Add IPTV; or choose Import from file and pick the .xspf file.
TS IPTV recognises XSPF by the <?xml …?> first line and the namespace and shows how many channels it found. On a TV, use a link if the TV has no file picker.

Common mistakes

Mistake	Symptom	Fix
Missing `<?xml version="1.0" encoding="UTF-8"?>` first line	Not recognised as a playlist	Put it at the very start of the file; TS IPTV currently needs it to detect XSPF.
Missing or wrong `xmlns`	Not recognised as a playlist	Use exactly `xmlns="http://xspf.org/ns/0/"`.
`&` in a URL not written as `&`	XML error	Write `&`.
The URL placed in `<title>` or `<info>`	The track does not play	Put the stream URL in `<location>`.
An element broken across several lines	Missing name or link	Keep each element on one line.
A track without `<title>`	The track is skipped	Each track needs both `<location>` and `<title>`.
Relying on `<duration>` for a live channel	No effect	Leave `<duration>` out for live streams.

What TS IPTV supports

Feature	Status
Track `location`, `title`, `image`	Supported on every platform
`vlc:id` as the channel id	Supported
Groups from `vlc:node`	Partial Group names are read, but tracks are not yet assigned to groups by `vlc:item tid`.
Elements written across several lines	Not supported Keep each element on one line.
Headers, DRM, programme guide	Not in XSPF Use M3U if you need them.

Danh sách phát XSPF

XSPF là gì

Cú pháp

Phần mở rộng của VLC

Ví dụ đầy đủ

Tạo một tệp

Bằng VLC

Bằng tay

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

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

XSPF playlists

What XSPF is

Syntax

VLC's extension

Complete example

Create one

With VLC

By hand

Host it

Add it in TS IPTV

Common mistakes

What TS IPTV supports

Related guides