⚠️ For the moment this functionality has only been tested under Kodi Leia (18)

Summary

Introduction

Since version 0.2.5 of the add-on it is possible to use the “TV” feature of Kodi to directly access the different live TV streams offered in Catch-up TV & More.

This feature has several advantages (non-exhaustive list):

  • Take full advantage of the TV guide managed by Kodi
  • Organize different channels into groups
  • One place to group the channels of other PVR (TNT, Satellite, …)
  • If a new TV channel is available in the add-on via an update, it is also available in the TV section of Kodi

A preview of the final result once you have followed this tutorial:

I. Prerequisites

If you have not already done so, it is necessary to proceed with the installation of Catch-up TV & More in order to take advantage of this feature. Just follow this tutorial before continuing here.

Some channels require to have a user account to access their service. The first thing to do is to create the accounts necessaries directly on the websites of concerned channels. Finally, it is required to fill your credentials in the parameters of the add-on.

Open Catch-up TV & More.

Access the settings of the add-on by pressing the left arrow on your keyboard or remote control.

Finally, go to the “Accounts” tab and fill in your username and password for the desired channels. Do not forget to confirm with the “OK” button to save your settings.

II. PVR “IPTV Simple Client”

1. Installing “PVR IPTV Simple Client”

The “TV” feature of Kodi requires the use of a PVR. In our case we will use the PVR “IPTV Simple Client”.

IPTV Simple Client will serve as a bridge between Kodi TV and the add-on Catch-up TV & More.
Indeed, we will provide the PVR a m3u file containing entries for each available channel in the add-on.
Each entry of this file associates a name of channel (for example France 2) with the Python file corresponding to this channel in the plugin (plugin://plugin.video.catchuptvandmore/main/live_bridge/?item_id=france-2&item_module=resources.lib.channels.fr.francetv).
So, when a channel is selected in Kodi TV, this last call in background Catch-up TV & More which deals with recovering the video stream before transmitting it back to Kodi which opens the player with the requested channel .

If Kodi is installed on Linux, you need to first install the PVR on your system with the command apt-get install kodi-pvr-iptvsimple.

To install “PVR IPTV Simple Client”, open “Add-ons”.

Then choose the open cardboard logo.

Install from repository.

PVR clients.

Select PVR IPTV Simple Client.

If it’s not installed, install-it.

2. Configuring “PVR IPTV Simple Client”

It is now necessary to configure IPTV Simple Client.

The first thing to do is to give IPTV Simple Client the m3u file to use, which is the list of channels you want to appear in Kodi TV.

In the “General” tab choose “Local path” for the location (1).

Finally, select “M3U Play List Path” to open the Kodi File Explorer (2).

The m3u files of each country are in the m3u folder present in the add-on folder (plugin.video.catchuptvandmore). This folder m3u is hidden by default in Kodi. You need to activate the option Show hidden files and directories present “System > Media” to have access to these m3u files.

The Kodi addons folder depends on your platform:

  • Windows: C:\Users\[user]\AppData\Roaming\Kodi\addons
  • Linux: /home/[user]/.kodi/addons
  • macOS: /Users/[user]/Library/Application Support/Kodi/addons
  • Android: /sdcard/Android/data/org.xbmc.kodi/files/.kodi/addons
  • LibreELEC: /storage/.kodi/addons
  • Shield Android TV: /internal/Android/data/org.xbmc.kodi/files/.kodi/addons
  • Amazon Fire: /External storage/Android/Data/org.xbmc.kodi/files/.kodi/addon

For others, you can find your “special://home” here.

Finally, go in the m3u folder by following this path:

  • plugin.video.catchuptvandmore/resources/m3u

Now you can choose the m3u file of you favourite country.

the file live_tv_all.m3u contains channels of all available countries.

Some countries have TV guides with XMLTV files. These files allow Kodi to display the schedules and program descriptions of your TV channels.

Go to the “EPG Settings” tab of the PVR IPTV Simple Client settings and select “XMLTV URL”.

Finally copy and paste your country guide (again, the tv_guide_all guide contains all TV guides of all available countries)

  • France: http://bit.ly/tvguidefr
  • Belgium: http://bit.ly/tvguidebe
  • All available countries: http://bit.ly/tvguideall

Programs may not be available for all channels

If the timezone of the XMLTV file is different from yours, you can adjust it using the “EPG Time Shift” setting

Finally, confirm the settings.

You must now restart Kodi

III. Organization of channels and groups of channels

1. Selecting the channels group

You have the option to choose which channel group to display in Kodi TV.

To do this, open “TV” and use the left arrow on your keyboard or remote control to access the group selection

2. Managing channels and groups

You can also edit and/or hide the different groups of channels. Also, it is possible to change the order of the strings.

To access channel and group managers simply follow the directions below.

IV. Recording Lives TV

The PVR IPTV Simple does not provide the functionnality to record lives TV. This part of the documentation will details all steps to add this functionnality easily. Other PVR’s exist (like “TVHeadend, …), which offer natively to record lives TV but required a backend deployed to work.

1. Prerequisites and limitations

The list of prerequisites are:

  • FFMPEG installed on the operating system used by Kodi (Windows, Linux, Raspbian, libreelec …) - This tutorial will not explain this topic but you can find easily in the internet how to install it if it not present in your environment.
  • The m3u file of Catch-up TV & More configured in the PVR IPTV Simple

Les limitations are:

  • IPTV Recorder does not permit to block the standby mode of Kodi instance during a recording ongoing or to wake up Kodi instance when a recording will start.
  • On Android, the deployement of FFMPEG is difficult. It is not present by default on the Play Store.
  • IPTV Recorder does not permit to record lives TV protected by DRM. If you test to record it, Kodi instance is stuck in some way and you may need to kill it.

2. Installing “IPTV Recorder”

Download et install the repository repository.primaeval-0.0.2 present at this url https://github.com/primaeval/repository.primaeval/raw/master/zips/repository.primaeval/repository.primaeval-0.0.2.zip

Go to the directory where this zip file repository.primaeval-0.0.2.zip is stored

Click on “OK” to install this repository

Install the add-on IPTV Recoder available on “Video Add-ons” from this newly installed repository.

3. Configuring and using “IPTV Recorder”

Go to the settings of the add-on “IPTV Recorder” to fill the path of the executable of FFMPEG

You have also the setting of the path where the recording will be stored. By default, the repository is special://temp (It is a variable of Kodi https://kodi.wiki/view/Special_protocol)

Go to the menu of this add-on to choose the program to record

Open the add-on “IPTV Recorder”

Go to “Channels Group”

Choose the program to record

Go back to the principal menu of “IPTV Recorder” and go to the “Recordings” menu. You will find all recordings in progress and finished.

At the end of the recording, you will find it at this place “special://temp” (if not changed previously) or throught the add-on “IPTV Recoder”. You could add this directory to the video sources of Kodi instance.