Kodi IPTV Setup Guide: IPTV Simple Client Walkthrough

Kodi is free, open-source media center software available on almost every platform — Windows, Mac, Android, Firestick, and more — and it's a popular choice among Canadian cord-cutters who want one interface for local media and live TV. It isn't an IPTV app on its own, but a built-in addon called IPTV Simple Client turns it into a fully capable IPTV player with a live TV guide.

Why Use Kodi for IPTV?

• One app for everything: if you already use Kodi for local media, add-ons, or a media library, you can watch IPTV in the same interface instead of switching apps.
• Free and open-source: IPTV Simple Client is a built-in PVR addon, not a paid product.
• Cross-platform: the same setup process works on Windows, Mac, Android, Android TV, and Firestick, since Kodi behaves consistently across platforms.

Step 1: Enable the IPTV Simple Client Addon

1. Open Kodi and go to Settings (the gear icon) > Add-ons.
2. Select My add-ons > PVR clients.
3. Find PVR IPTV Simple Client in the list and select it.
4. Click Enable, then Configure.

Step 2: Enter Your Playlist

Inside the addon's configuration screen, go to the General tab:

• M3U Play List URL: select "Remote path" and paste your M3U URL.
• Xtream Codes: IPTV Simple Client also supports Xtream Codes directly — select the Xtream Codes option in a newer version of the addon and enter your server URL, username, and password instead of a raw M3U link.

Step 3: Add Your EPG

Still inside the addon settings, go to the EPG Settings tab:

• XMLTV URL: select "Remote path" and paste your EPG URL (if you were provided one separately from your M3U link).

Save your settings, then restart Kodi. This last step matters — Kodi needs a restart to fully load a new PVR configuration.

Step 4: Watch Live TV

After restarting, go to the TV section from Kodi's home screen. Give it a minute the first time — Kodi needs to index the full channel list and EPG data before everything appears correctly.

Useful Settings Worth Adjusting

The default IPTV Simple Client configuration is set up conservatively, and a few extra settings make a real difference once your channels are loading:

• Stream timeout: in the addon's General tab, increasing the timeout value gives Kodi more time to connect to a slow-loading server before it gives up and shows an error — useful if your provider's server is farther away or busier during peak hours.
• Catch-up TV / Timeshift: if your provider supports catch-up, IPTV Simple Client has settings under the General or Catchup section to enable it, letting you rewind live channels that support the feature.
• Number of channel groups: if your playlist has categories built in (Sports, News, Movies, etc.), enabling "Use category as channel group" in the addon settings organizes your channel list into folders instead of one long list, which is much easier to navigate with a remote.
• EPG time offset: if your guide loads but times are shifted, the EPG Settings tab has a manual time offset field you can use to correct it without needing your provider to change anything.

Troubleshooting

Channels load but the EPG is empty: double-check the XMLTV URL was entered exactly as provided, with no extra spaces. A wrong or missing EPG URL is the most common cause of a blank guide in Kodi.

Playback stutters or buffers: Kodi's default buffer settings are conservative. Go to Settings > Player > Videos and increase the cache size, which gives Kodi more room to absorb brief network dips without freezing. If buffering only happens during peak evening hours, that's often ISP traffic management on major Canadian networks rather than a Kodi setting — see our buffering guide for details.

Channels stop working after a while: playlists can expire from Kodi's cache. Go back into the IPTV Simple Client settings and re-save your M3U or Xtream Codes details to force a refresh.

"PVR Manager is starting up" message never goes away: this usually means Kodi is stuck trying to load a very large playlist or a slow-responding EPG source. Give it a few extra minutes on first load; if it never resolves, disable the addon, restart Kodi, then re-enable and reconfigure it.

Kodi crashes or freezes when opening the TV section: this is often caused by a corrupted addon settings file rather than the playlist itself. Disabling and re-enabling IPTV Simple Client, or in stubborn cases uninstalling and reinstalling it fresh, usually clears this up.

Kodi on Firestick vs Kodi on Windows/Android

The setup steps for IPTV Simple Client are identical across platforms, but performance differs. Firestick's more limited processor and RAM mean Kodi can feel noticeably slower to load large channel lists and EPG data than the same setup on a Windows PC or a mid-range Android TV box. If you're specifically installing Kodi on a Firestick for IPTV, see our guide on sideloading apps on Firestick for the installation steps, and expect the first EPG load after setup to take longer than it would on a desktop.

FAQ

Do I need to pay for IPTV Simple Client? No. IPTV Simple Client is a free, built-in PVR addon included with Kodi — there's no separate purchase or subscription needed to use it.

Can I use both an M3U playlist and Xtream Codes in Kodi at the same time? Not within a single IPTV Simple Client instance — each configuration supports one playlist source at a time. Some users run multiple PVR client instances for multiple sources, but this is an advanced setup most people don't need.

Why does Kodi say my M3U URL is invalid when it works in a browser? This is almost always a copy-paste issue — an extra space, missing character, or line break introduced when the URL was entered. Re-type the URL carefully in the addon's General settings rather than pasting it.

Does Kodi support EPG catch-up or rewind on live channels? It can, but only if your provider's playlist includes catch-up data and the IPTV Simple Client catch-up settings are enabled — it's not automatic for every channel.

Is Kodi better than TiviMate or IPTV Smarters Pro for IPTV? It depends on your priorities. Kodi is a stronger choice if you want one app for local media and IPTV together; dedicated apps like TiviMate tend to offer a more polished, IPTV-specific interface out of the box. See our TiviMate vs IPTV Smarters Pro comparison for more on the dedicated-app side.

Need Help?

Visit our FAQ or contact support if you run into an issue not covered here.

Related Guides

Comparing IPTV players? See our TiviMate vs IPTV Smarters Pro comparison, or check out our other setup guides for PC/Mac/Linux via VLC. For every device we support, see our full IPTV Setup Guide.