Documentação — ThePlay

Primeiros passos

ThePlay is an IPTV player for Samsung Smart TVs (Tizen 3.0+). Follow these steps to get started.

Installation

Install ThePlay on your Samsung TV from the Tizen package file (.wgt). The app requires the following TV permissions: Internet access, network info, audio control, and filesystem read (for USB support).

First Launch

On first launch, ThePlay shows a setup wizard that guides you through:

Language — Choose your preferred language
Theme — Pick one of 9 color themes
Playlist — Add your channels via URL, USB, or Remote pairing
EPG — Configure programme guide sources (auto-detected or manual)

Adding Channels

You can add M3U playlists in three ways:

URL — Enter the HTTP/HTTPS URL of your M3U playlist directly
USB — Insert a USB drive with .m3u or .m3u8 files and browse to select
Remote — Pair the TV with the web portal and manage playlists from your computer or phone

Formato de playlist

ThePlay supports the M3U/M3U8 playlist format compatible with pvr.iptvsimple.

#EXTM3U url-tvg="http://example.com/epg.xml"
#EXTINF:-1 tvg-id="ch1" tvg-name="Channel One" tvg-logo="http://example.com/logo.png" group-title="News",Channel One HD
http://stream.example.com/channel1/index.m3u8

Custom Headers (Pipe Syntax)

http://stream.example.com/live.m3u8|user-agent=MyPlayer&referer=http://example.com

Tags M3U suportadas

Tag	Description	Example
`tvg-id`	Channel ID for EPG matching	`tvg-id="bbc1.uk"`
`tvg-name`	Channel name for EPG fallback	`tvg-name="BBC One"`
`tvg-logo`	Channel logo URL	`tvg-logo="http://..."`
`tvg-chno`	Custom channel number	`tvg-chno="101"`
`group-title`	Category/group	`group-title="News;UK"`
`catchup`	Catchup mode	`catchup="default"`
`catchup-source`	Catchup URL template	`catchup-source="...{utc}..."`
`catchup-days`	Days of available archive	`catchup-days="7"`

Modos de arquivo

Mode	Description
`default`	Uses `catchup-source` as the full URL template
`append`	Appends `catchup-source` to the live stream URL
`shift`	Adds timeshift parameters to the stream URL
`flussonic` / `fs`	Flussonic server `timeshift_abs` format
`xc`	Xtream Codes archive format transformation
`vod`	Video on demand direct URL

URL Template Variables

{utc} {utcend} {duration} {offset} {Y} {m} {d} {H} {M} {S} {lutc} {timestamp}

Configuração de EPG

ThePlay loads programme guide data from XMLTV sources. Auto-detection from url-tvg/x-tvg-url headers, or add manually in Settings > EPG.

Channel Matching

tvg-id → channel id in XMLTV
tvg-name → display-name in XMLTV
Channel display name → display-name in XMLTV

Gerenciamento remoto

Pairing a TV

On the TV, select Remote as the playlist source
The TV displays a 6-character pairing code (valid for 10 minutes)
On your computer or phone, log in to the web portal
Click Pair Device and enter the code
The TV confirms pairing and begins syncing playlists

Controle remoto

Action	TV Remote	PC Keyboard
Navigate	Arrow keys	Arrow keys
Select	Enter / OK	Enter
Back	Return	Escape
Channel List	Guide / Yellow	G / F2
EPG Grid	Info / Green	I / F1
Settings	Menu / Blue	M / F3
Play / Pause	Play/Pause	Space

Solução de problemas

Stream not playing

Verify the stream URL works in VLC on a PC
Check if the stream requires specific headers — add them via pipe syntax
Try restarting the TV (power cycle)

EPG not showing

Check that tvg-id matches channel id in the XMLTV file
Adjust timezone offset in Settings > EPG

Remote pairing fails

Pairing codes expire after 10 minutes — request a new one
No ambiguous characters: I, O, 0, 1 are excluded from codes