ContextQMD
Back to Tv

直播來源格式說明

docs/LIVE.md

latest13.0 KB
Original Source

直播來源格式說明

LiveParser 依內容自動偵測格式，支援三種直播來源：

格式判斷條件
JSON內容為 JSON（[ 開頭）
M3U任一行含 #EXTM3U（且不含 #genre#）
TXT其他

目錄

TXT 格式

每行以逗號 , 分為兩欄。含 #genre# 的行宣告分組，含 :// 的行為頻道。

分組名稱,#genre#
頻道名稱,播放URL

行的解析規則：

行的形式說明
名稱,#genre#宣告新分組，後續頻道歸入此分組
名稱,URL頻道項目（第二欄含 ://）
名稱_密碼,#genre#建立密碼保護的隱藏分組
不含 :// 的行頻道指令行，作用至下一個 #genre#
首個頻道前無 #genre#自動建立無名預設分組

多線路備援：以 # 分隔多個 URL，播放器依序嘗試：

CCTV1,http://cdn1.example.com/cctv1.m3u8#http://cdn2.example.com/cctv1.m3u8

行內標頭：URL 後接 |key=value，多個以 & 連接，多線路時每段各自帶標頭：

CCTV1,http://cdn1.example.com/cctv1.m3u8|User-Agent=okhttp#http://cdn2.example.com/cctv1.m3u8|Referer=https://example.com/

範例：

新聞台,#genre#
CCTV1,http://cdn1.example.com/cctv1.m3u8#http://cdn2.example.com/cctv1.m3u8
鳳凰資訊,http://example.com/phoenix.m3u8|User-Agent=Mozilla/5.0

體育台,#genre#
ua=Mozilla/5.0
referer=https://sports.example.com/
CCTV5,http://example.com/cctv5.m3u8
CCTV5+,http://example.com/cctv5plus.m3u8

電影台,#genre#
header={"Authorization":"Bearer token123"}
HBO,http://example.com/hbo.m3u8

成人_secretpass,#genre#
某頻道,http://example.com/adult.m3u8

M3U 格式

以 #EXTM3U 開頭，每個頻道由 #EXTINF: 行與其後的 URL 行組成，中間可插入任意指令行。

m3u
#EXTM3U [全域屬性...]
#EXTINF:-1 [頻道屬性...],頻道顯示名稱
[選用指令行...]
http://example.com/stream.m3u8[|行內標頭]

#EXTM3U 全域屬性

屬性說明
tvg-url="…"XMLTV EPG 節目表 URL（僅當 Live 配置未設定 EPG 時生效）
url-tvg="…"同 tvg-url，備用寫法（同上條件）
catchup="…"全域預設追看類型
catchup-source="…"全域追看 URL 模板
catchup-replace="…"全域追看 URL 替換字串
m3u
#EXTM3U tvg-url="https://epg.example.com/xmltv.xml" catchup="append" catchup-source="?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"

#EXTINF 頻道屬性

屬性寫在逗號前，頻道顯示名稱寫在逗號後至行尾。

屬性說明
tvg-id="…"EPG 頻道 ID
tvg-name="…"EPG 頻道名稱（可與顯示名稱不同）
tvg-chno="…"頻道號碼
tvg-logo="…"頻道 Logo URL
group-title="…"所屬分組名稱
http-user-agent="…"播放請求 User-Agent
catchup="…"此頻道追看類型，覆蓋全域設定
catchup-source="…"此頻道追看 URL 模板
catchup-replace="…"此頻道追看替換字串
m3u
#EXTINF:-1 tvg-id="CCTV1" tvg-name="CCTV-1" tvg-chno="1" tvg-logo="https://example.com/logo/cctv1.png" group-title="央視",CCTV-1

M3U 專屬指令行

在 #EXTINF: 與 URL 行之間插入，作用於緊接的下一個 URL（通用指令同樣適用）。

指令說明
#EXTHTTP:{"Key":"Value"}JSON 格式 HTTP 標頭
#EXTVLCOPT:http-user-agent=…VLC 風格 User-Agent
#EXTVLCOPT:http-referrer=…VLC 風格 Referer
#EXTVLCOPT:http-origin=…VLC 風格 Origin
#KODIPROP:…DRM 與媒體格式，詳見 DRM 宣告

行內標頭：URL 末接 |key=value&key2=value2：

m3u
http://example.com/stream.m3u8|User-Agent=Mozilla/5.0&Referer=https://example.com/

範例：

m3u
#EXTM3U tvg-url="https://epg.example.com/xmltv.xml.gz" catchup="append" catchup-source="?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"

#EXTINF:-1 tvg-id="CCTV1" tvg-chno="1" tvg-logo="https://example.com/logo/cctv1.png" group-title="央視",CCTV-1
http://cdn1.example.com/cctv1.m3u8

#EXTINF:-1 tvg-id="CCTV5" group-title="央視",CCTV-5 體育
#EXTVLCOPT:http-user-agent=Mozilla/5.0
#EXTVLCOPT:http-referrer=https://sports.example.com/
http://cdn1.example.com/cctv5.m3u8|User-Agent=Mozilla/5.0

#EXTINF:-1 group-title="加密頻道",Premium HD
#KODIPROP:inputstream.adaptive.license_type=widevine
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|User-Agent=Mozilla/5.0
format=mpd
http://example.com/premium.mpd

#EXTINF:-1 group-title="加密頻道",PlayReady 頻道
#KODIPROP:inputstream.adaptive.drm_legacy=playready|https://license.example.com/playready
http://example.com/playready.mpd

#EXTINF:-1 group-title="一般頻道",需解析頻道
parse=1
click=https://example.com/click
http://example.com/parse-needed.m3u8

#EXTINF:-1 group-title="帶標頭頻道",自訂標頭
#EXTHTTP:{"Authorization":"Bearer mytoken","X-Custom":"value"}
http://example.com/auth-stream.m3u8

JSON 陣列格式

內容以 [ 開頭時，直接反序列化為 List<Group>，結構與 Live 配置的 groups 欄位相同。

json
[
  {
    "name": "新聞台",
    "channel": [
      {
        "name": "TVBS新聞台",
        "urls": [
          "http://cdn1.example.com/tvbs.m3u8",
          "http://cdn2.example.com/tvbs.m3u8"
        ],
        "number": "56",
        "logo": "https://example.com/logo/tvbs.png",
        "tvgId": "TVBS",
        "ua": "Mozilla/5.0",
        "catchup": {
          "type": "append",
          "source": "?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"
        }
      }
    ]
  },
  {
    "name": "加密頻道",
    "pass": "secretpass",
    "channel": [
      {
        "name": "Premium",
        "urls": [
          "http://example.com/premium.mpd"
        ],
        "format": "application/dash+xml",
        "drm": {
          "type": "widevine",
          "key": "https://license.example.com/widevine",
          "header": {
            "User-Agent": "Mozilla/5.0"
          }
        }
      }
    ]
  }
]

完整欄位定義見 CONFIG.md — channel 頻道項目。

頻道指令

以下指令在 M3U 與 TXT 格式中均適用，寫法完全一致。

  • TXT：指令行寫在頻道行前，作用至下一個 #genre#（包含該分組內所有後續頻道及其多線路 URL）。
  • M3U：指令行寫在 #EXTINF: 與 URL 行之間，僅作用於緊接的下一個 URL（每個 URL 處理後立即清除）。
指令範例說明
ua=ua=Mozilla/5.0播放請求 User-Agent
origin=origin=https://example.com請求 Origin 標頭
referer=referer=https://example.com/請求 Referer 標頭（referrer= 雙 r 寫法同樣接受）
header=header={"X-Token":"abc"}任意 HTTP 標頭（JSON 格式）
format=format=mpd強制指定媒體格式
parse=parse=11 = 需透過解析器處理此 URL
click=click=https://example.com/c點擊攔截處理 URL
forceKey=forceKey=true強制使用 DRM 金鑰

format 可選值：

值說明
hlsHLS 串流（application/x-mpegURL）
dash 或 mpdMPEG-DASH 串流（application/dash+xml）

DRM 宣告

僅 M3U 格式支援，透過 #KODIPROP: 行宣告，寫在 #EXTINF: 與 URL 行之間。

指令說明
#KODIPROP:inputstream.adaptive.license_type=…DRM 類型：widevine / playready / clearkey
#KODIPROP:inputstream.adaptive.license_key=…DRM 授權伺服器 URL（或 ClearKey JSON）
#KODIPROP:inputstream.adaptive.drm_legacy=類型|URL快速宣告，類型與授權 URL 合一
#KODIPROP:inputstream.adaptive.manifest_type=…媒體格式：mpd / dash / hls
#KODIPROP:inputstream.adaptive.stream_headers=…串流請求標頭（key=val&key2=val2）
#KODIPROP:inputstream.adaptive.common_headers=…通用請求標頭（同上格式）

授權伺服器標頭：附加於 license_key URL 後，以 | 分隔：

m3u
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|User-Agent=Mozilla/5.0&token=abc

標準寫法（Widevine）：

m3u
#EXTINF:-1 group-title="加密頻道",Premium HD
#KODIPROP:inputstream.adaptive.license_type=widevine
#KODIPROP:inputstream.adaptive.license_key=https://license.example.com/widevine|User-Agent=Mozilla/5.0
format=mpd
http://example.com/premium.mpd

快速寫法（drm_legacy）：

m3u
#EXTINF:-1 group-title="加密頻道",PlayReady 頻道
#KODIPROP:inputstream.adaptive.drm_legacy=playready|https://license.example.com/playready
http://example.com/playready.mpd

ClearKey（本地 JSON 金鑰）：

m3u
#EXTINF:-1 group-title="加密頻道",ClearKey 頻道
#KODIPROP:inputstream.adaptive.license_type=clearkey
#KODIPROP:inputstream.adaptive.license_key={"keys":[{"kty":"oct","k":"base64key","kid":"base64kid"}],"type":"temporary"}
http://example.com/clearkey.mpd

ClearKey（簡短 hex 格式）： 以 kid_hex:key_hex 表示，多對以逗號分隔，框架自動轉換為標準 JSON：

m3u
#KODIPROP:inputstream.adaptive.license_type=clearkey
#KODIPROP:inputstream.adaptive.license_key=a7e61c373e219033c21091c302f996c5:100b6c20940f779a4589152b57d2dacb
http://example.com/clearkey.mpd

stream_headers 也支援 drmScheme / drmLicense 鍵名：

m3u
#KODIPROP:inputstream.adaptive.stream_headers=drmScheme=widevine&drmLicense=https://license.example.com/

追看/時移

在 #EXTM3U、#EXTINF 或 Live 配置的 catchup 欄位中設定，頻道層級設定覆蓋全域。

type 可選值：

值說明
append將 source 模板附加至原始 URL 末尾（預設）
default以格式化後的 source 完全替換原始 URL

PLTV 自動追看：若頻道未設定任何追看，但播放 URL 含有 /PLTV/，框架會自動套用內建的 PLTV 追看設定（append 類型，7 天，替換 /PLTV/ → /TVOD/，模板 ?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}），無需手動設定。

source 模板變數：

變數說明輸出範例
${(b)yyyyMMddHHmmss}節目開始時間20260312140000
${(e)yyyyMMddHHmmss}節目結束時間20260312150000
{utc:}節目開始 Unix 時間戳（秒）1741780800
{utcend:}節目結束 Unix 時間戳（秒）1741784400

範例（append 類型）：

catchup="append" catchup-source="?playseek=${(b)yyyyMMddHHmmss}-${(e)yyyyMMddHHmmss}"

catchup-replace 用途：

組合時移 URL 前，先對原始 URL 執行字串替換。格式為 原字串,新字串（逗號分隔）：

catchup-replace="/PLTV/,/TVOD/"