Skip to content

Player guide

PVR IPTV Simple Client: Kodi with a full TV guide

The free PVR IPTV Simple Client add-on turns Kodi into a full IPTV player with a guide grid. Here is how to install it, where your two links go, how to load fewer channels on small boxes and how to fix the usual problems.

PVR IPTV Simple Client: a media centre window with a TV guide grid and a red line marking now
Quick answer
  • PVR IPTV Simple Client is a free Kodi add-on that turns Kodi into a full IPTV player: give it your M3U link and your TV guide link, and Kodi shows your channels with a guide grid.
  • Install it from Settings > Add-ons > Install from repository > PVR clients, then open Configure: the M3U link goes in M3U playlist URL, the guide link in XMLTV URL.
  • It suits computers and Android TV boxes. On Smart TVs, Fire TV and Apple devices, Hot Player or another app is easier.

What the IPTV Simple Client does

Kodi is a free, open-source media centre run by the non-profit Kodi Foundation. On its own, Kodi has no TV channels: its TV section needs an add-on that brings them in. PVR IPTV Simple Client is that add-on for IPTV. It reads an M3U playlist for the channels and an XMLTV file for the guide, and Kodi shows both in its own TV menu with a guide grid.

The IPTV Simple Client is free, open source and sits in Kodi’s own add-on repository, so there is nothing to download from other websites. Like every player, it has no channels of its own. Everything you watch comes from your plan; with IPTV.sg, from the two links in the message we send after you order. Our guides to the M3U playlist and to EPG in IPTV explain what is inside each link.

An IPTV TV guide grid showing what is on now and next on each channel
With the guide link, Kodi fills a grid like this one.

Kodi takes the most steps to set up, but rewards you with a large, tidy guide. VLC opens the same playlist faster but shows one long list with no guide, and Hot Player is the easiest choice because we activate it for you. Our list of the best IPTV player apps compares six players side by side.

What you need for the IPTV Simple Client

  • Kodi 21 “Omega”. The current version in November 2026; the menu names below are from it. Get it from kodi.tv (Windows, Mac, Linux), the Microsoft Store, or Google Play on Android TV and Google TV, where the Kodi Foundation lists it.
  • Your two links. The M3U link brings the channels and the guide link (XMLTV) brings the TV guide. Both are in our message. If you only have the three-box Xtream Codes login, ask us on WhatsApp for the two links.
  • A keyboard, or your phone. The links are long. Copy and paste them on a computer; on a TV box, type with the keyboard in the Google TV phone app rather than with the remote.
  • A steady connection. Allow about 10 Mbps for each screen in HD and 25 Mbps in 4K. A cable or a strong Wi-Fi signal matters more than your plan speed.

Kodi playing a channel counts as one screen in your plan, the same as any other player. Our guide to IPTV on multiple devices explains how screens and accounts work on Standard and Premium.

Set up the IPTV Simple Client in 4 steps

Kodi IPTV in 4 steps: install Kodi, add PVR IPTV Simple Client, paste the M3U and XMLTV links, open TV and Guide
Four steps, about ten minutes.
  1. Install Kodi and open it once, so it finishes its first start.
  2. Add the add-on. Open Settings (the gear icon), then Add-ons > Install from repository. If Kodi asks which repository, choose Kodi Add-on repository. Open PVR clients, choose PVR IPTV Simple Client and then Install.
  3. Paste your two links. In Add-ons, open My add-ons > PVR clients > PVR IPTV Simple Client and choose Configure. Kodi 21 first shows a short list: choose the line that starts with Edit, or Add add-on configuration if there is none. Under General, check that Location says Remote path (Internet address), then paste the M3U link into M3U playlist URL. Under EPG Settings, paste the guide link into XMLTV URL. Choose OK.
  4. Open TV > Guide on the home screen. Kodi loads the channels first and then fills the guide. With a big plan, the first load can take a few minutes, so let it finish.

The IPTV Simple Client settings that matter

Only a handful of the add-on’s many settings matter for a normal plan:

Where the links go in PVR IPTV Simple Client: Location Remote path, M3U playlist URL under General, XMLTV URL under EPG Settings
Menu names from Kodi 21.
SettingWhereWhat to choose
LocationGeneralRemote path (Internet address). It is already set this way.
M3U playlist URLGeneralYour M3U link
Auto refresh modeGeneralOnce per day, so new channels appear without you doing anything. Refresh hour (24h) sets the time; 4 means 4 am.
XMLTV URLEPG SettingsYour TV guide link
EPG time shiftEPG Settings0 hours. Change it only if the guide is off by whole hours on every channel.
TV group modeGroupsAll groups, or Some groups for a shorter list (next section)

The settings window has four levels: Basic, Standard, Advanced and Expert. If you cannot see one of these settings, raise the level in that window.

Big plans: load fewer channels in the IPTV Simple Client

A full IPTV plan has thousands of channels, and Kodi reads them all, plus the guide, each time it starts. On a small Android TV box that can make Kodi slow to open, so load only the groups you really watch.

TV group mode in PVR IPTV Simple Client: All groups, Some groups (up to 5) or Custom groups
Some groups is the quick win on small boxes.
  1. Let Kodi load everything once, then open TV > Channels and note the names of the groups you want, for example your country or sport.
  2. In the add-on settings, open Groups and set TV group mode to Some groups.
  3. Set Number of TV groups (up to 5) and type each name into TV group 1, TV group 2 and so on, exactly as Kodi showed it, capital letters and spaces included.

Choose OK and Kodi reloads with the shorter list. Need more than five? Custom groups reads names from a file. Not sure what each group holds? Browse the IPTV Singapore channels list, sorted by country and type.

Which devices suit Kodi with the IPTV Simple Client

Where Kodi suits IPTV: computers and Android TV yes; iPhone, iPad and Apple TV no; Smart TVs and Fire TV use Hot Player
Checked in November 2026.
  • Windows and Mac. The best home for Kodi: a big screen and a keyboard for the links. Our guides to IPTV for PC and IPTV on Mac compare Kodi with the simpler players.
  • Android TV and Google TV. Kodi is in Google Play. On boxes with little memory, use Some groups from the section above. Our guide to IPTV on Android TV lists the other good players.
  • Android phones. Google Play lists Kodi as not designed for smaller phones, so a phone app is easier: see IPTV on Android phone.
  • iPhone, iPad and Apple TV. Kodi is not in the App Store; the Kodi Foundation’s only App Store app is a remote control for Kodi. Use Smarters Player Lite, Hot Player or VLC instead (iPhone and iPad, Apple TV).
  • Samsung, LG and Fire TV. Hot Player is the easy choice, and we activate it with your plan (Samsung, LG, Firestick).

Watching TV with the IPTV Simple Client

Everything lives under TV on Kodi’s home screen. Channels shows the list, grouped as in your playlist, and Guide shows the grid. By default, choosing a programme in the guide shows its details first. To jump straight to the channel instead, open Settings > PVR & Live TV > Guide and set Default select action to Switch to channel.

On a keyboard, a few keys make Kodi much quicker while you watch a channel full screen:

KeyWhat it does
Page Up / Page DownNext or previous channel
COpens the channel list over the picture
GOpens the guide
EnterShows the on-screen controls

Prefer one app for everything, with films and series menus too? TiviMate on Android TV and Hot Player on Smart TVs give a similar guide with fewer settings.

Fixing common problems with the IPTV Simple Client

What you seeWhat to try
No channels after a few minutesCopy the M3U link again in full into M3U playlist URL, check that Location says Remote path (Internet address), then restart Kodi.
Channels, but the guide is emptyPaste the guide link into XMLTV URL under EPG Settings and give Kodi a few minutes. Still empty? Settings > PVR & Live TV > Guide > Clear data, which reloads the guide.
Guide times are wrongSet the time zone and clock on the device first (Singapore is UTC+8). Change EPG time shift only if every channel is still off by the same number of hours.
Kodi is slow to openLoad fewer channels: Groups > TV group mode > Some groups.
Old or doubled channels after a changeSettings > PVR & Live TV > General > Clear data. Kodi forgets its stored channels, groups and guide and loads them again from the add-on; your two links stay.
Buffering or freezingUse a cable or a stronger Wi-Fi signal, and close other players using the plan.
Every channel fails at onceYour plan may have ended. Renew it and the same links work again.

Buffering in every player, not only Kodi? Work through our IPTV buffering fix, and the IPTV troubleshooting checks for other errors. Still stuck? Message us on WhatsApp with the device, the Kodi version and a photo of the screen.

Next steps

The IPTV Simple Client is a free way to watch your IPTV.sg channels in Kodi; the plan brings the channels, the two links and our help on WhatsApp.

IPTV Simple Client: FAQ

Is PVR IPTV Simple Client free?

Yes. Both Kodi and the PVR IPTV Simple Client add-on are free and open source. The channels come from your IPTV plan.

Does the IPTV Simple Client work with an Xtream Codes login?

It takes links rather than the three-box login: an M3U link for the channels and an XMLTV link for the guide. Ask us for both on WhatsApp. Our guide to Xtream Codes explains the difference.

Can I use Kodi on a Firestick for IPTV?

Hot Player is simpler on Fire TV, and we activate it with your plan. Our guide to IPTV on Firestick shows the steps.

Is the IPTV Simple Client safe?

Yes, when you install it from Kodi’s own add-on repository, as in the steps above. Avoid Kodi builds and add-on packs from other websites; our guide to the IPTV APK explains the risks.

Guide

IPTV on VLC

Play your M3U link in VLC on a computer, phone or TV, find channels fast and fix buffering.

Need your two links?

Message us on WhatsApp with your order number, and we send your M3U and TV guide links and help you set up Kodi.