Lumen·wiki
All guides / Setup
easy ~5 min · Updated 2026-04-30

What you’ll need

  • Your IPTV provider’s M3U / M3U8 URL or Xtream Codes credentials (host + username + password).
  • A working internet connection on the TV.

If you don’t have a provider yet, see our providers page for a list of legal sources, including the IPTV-org public playlist (free, no signup).

M3U URL

The simplest format. Most providers expose an M3U or M3U8 URL that points to a list of channels.

  1. Open Lumen·TV on your TV.
  2. Press the gear icon (top-right) to open Settings.
  3. Choose PlaylistAdd SourceM3U URL.
  4. Paste your URL. The remote keyboard accepts URL fragments — typing it character by character on a virtual keyboard is painful, so we recommend the LG TV’s “Send to TV” feature from your phone, or the on-screen QR code option (Settings → Playlist → Add via QR).
  5. Optional: paste an XMLTV EPG URL if your provider exposes one separately. (If the M3U includes tvg-url= directives, this is auto-detected.)
  6. Save. Channels populate within 30 seconds.

Auto-refresh

Lumen·TV refreshes your M3U source every 24 hours by default. To change:

Settings → Playlist → <source name> → Refresh interval — choose 6h / 12h / 24h / never.

What if the URL contains spaces or special characters?

Encode them. https://example.com/playlist with spaces.m3u becomes https://example.com/playlist%20with%20spaces.m3u. Most providers already give you a clean URL.

Xtream Codes

The other widely-supported format. Better than M3U because it ships live + VOD + series in a single login, and the EPG is included.

  1. Settings → Playlist → Add Source → Xtream Codes.
  2. Enter:
    • Host: your provider’s URL with port, e.g. http://your-provider.example:8080. Note the protocol — many providers still serve over plain HTTP.
    • Username: as given by your provider.
    • Password: as given by your provider.
  3. Save. Lumen·TV calls player_api.php with three actions (get_live_categories, get_live_streams, get_vod_streams) and populates everything in one go.

Where do my categories go?

Xtream provides a flat list of channels with category_id. Lumen·TV groups them automatically. To collapse / rename / reorder groups, go to Settings → Playlist → Groups.

Multiple playlists

Stack as many as you want. Each gets a prefix in the channel list to keep them organized.

Settings → Playlist → Add Source → repeat for each.

To remove a source: Settings → Playlist → <source name> → Remove. Channels disappear; favorites and groups are preserved (orphaned channels are quietly hidden).

Common errors

ErrorMost likely causeFix
“Could not parse playlist”URL returns HTML (login wall, captcha) instead of M3UVerify the URL works in a browser first. Some providers block non-mobile UAs — see the user-agent guide.
“404” or “403” on the URLWrong URL, IP-locked, or your subscription expiredTest in VLC on a computer to isolate.
“Connection timed out”Provider blocks LG TV’s geo / IP rangeTry a VPN setup on the TV’s network or a router-level rule.
“Playlist loaded but no channels”M3U has unusual encoding (Windows-1252 instead of UTF-8)We auto-detect UTF-8 / UTF-16 / Latin-1. If yours is something else, contact us.

Next

Was this helpful?

Edit suggestions: wiki@lumentv.app · Open an issue on GitHub.