Skip to content

The TV pane

Open it with open tv (typed or spoken in the command bar), from the command palette (Open TV), or the left toolbar. The TV pane plays live channels from the public iptv-org catalog — news, sport, music, and everything else — right on the canvas next to your agents.

  1. Browse by genre, country, or language with the dropdowns under the player.
  2. Search all channels globally by name.
  3. Star a channel to add it to Favorites; recently watched channels collect under Recents.

Play/pause, volume, closed captions (when the stream carries them), the channel name, favorite star, and fullscreen. The player area and the channel browser are a draggable split — set the ratio you like and it persists.

Click the calendar button in the control row to open the guide — it loads automatically, no setup needed. The built-in guide merges public XMLTV feeds for the major free streaming services (Pluto TV, Samsung TV Plus, Plex, Roku, PBS), which cover most of the reliably watchable channels in the catalog. The guide overlays the player with a NOW card, the running programme highlighted, and the upcoming schedule for the playing channel (times shown in your local time; matching uses the channel’s tvg-id, then its name).

Want a different lineup? Click Use a custom guide URL and paste an XMLTV URL (.xml or .xml.gz) — your IPTV provider’s guide link, or the guide.xml a self-run iptv-org/epg install serves. A custom URL replaces the built-in sources entirely.

  • Guides load through the app’s local proxy, so provider links that refuse browser connections still work; .gz guides decompress automatically.
  • If the guide has no entry for a channel, the panel says so — the built-in feeds don’t cover national broadcasters, so for those you’ll want a provider or self-run guide.
  • Change guide URL swaps sources; saving an empty URL returns to the built-in guide.
  • Playback uses a local HLS proxy inside the app, so streams that refuse browser connections still play.
  • Channel availability is inherently flaky (public streams) — Retry or switch; nothing on your end is broken.

Frequently asked questions

Why does a channel say 'Stream unavailable'?

Public IPTV streams come and go — a channel may be geo-blocked, temporarily offline, or in an unsupported format. Hit Retry, or just pick another channel; availability is on the broadcaster, not your setup.

Where does the TV Guide get its data?

Out of the box, from built-in public XMLTV feeds covering the major free streaming services (Pluto TV, Samsung TV Plus, Plex, Roku, PBS). You can replace them with your own XMLTV URL — an IPTV provider's guide link, or the guide.xml served by a self-run iptv-org/epg install. iptv-org itself publishes no hosted programme data.