Skip to content

Clients

The clients block represents a list of IPTV clients. Each client typically corresponds to a single device or user accessing the IPTV service. Clients are identified by their unique name and authenticated using a secret key.

Each client can access the following endpoints:

  • {public_url}/{client_secret}/playlist.m3u8
  • {public_url}/{client_secret}/epg.xml
  • {public_url}/{client_secret}/epg.xml.gz

Note

Omit playlists/epgs to give the client access to everything. Generated channels are delivered through their parent playlist, so selecting a playlist also delivers its channels.

YAML Structure

clients:
  - name: ""
    secret: ""
    proxy: {}
    playlists: []
    epgs: []

Fields

Field Type Required Description
name string Yes Unique name identifier for this client
secret string Yes Authentication secret. Treat it like a password — it is the only credential and appears in the client's URLs.
playlists []string No List of playlist names for this client. Generated channels arrive through their parent playlist.
epgs []string No List of EPG names for this client.
proxy Proxy No Optional per-client proxy config

Examples

Basic Client Configuration

clients:
  - name: living-room-tv
    secret: "living-room-secret-123"
    playlists: "sports-playlist"

Client with Multiple Playlists and EPGs

clients:
  - name: family-tablet
    secret: "family-tablet-secret-456"
    playlists: ["basic-playlist", "kids-playlist"]
    epgs: ["main-epg", "kids-epg"]

Client with Proxy Configuration

clients:
  - name: streaming-device
    secret: "streaming-device-secret-789"
    playlists: ["premium-channels"]
    proxy:
      enabled: true
      concurrency: 2