Enigma2 PVR

Enigma2 PVR client addon for Kodi. Enigma2 is a open source TV-receiver/DVR platform which Linux-based firmware (OS images) can be loaded onto many Linux-based set-top boxes (satellite, terrestrial, cable or a combination of these) from different manufacturers. This add-on leverages the OpenWebIf project to interact with the Enigma2 device via Restful APIs.

Multiple E2 devices can be configured via Kodi PVR since Kodi 20 (Nexus). To setup multiple devices simply visit the add-ons settings under Configure, and choose new Add add-on configuration.

Supports streaming of Live TV & Recordings with features such as Timeshifting, EPG, Timers and Autotimers. In addition the majority of Enigma2 devices support viewing and recording IPTV streams. The add-on supports IPTV by simply passing the URL to inputstream.ffmpegdirect, allowing a local timeshift feature similar to native Enigma2 streams.

Note: Some images do not use OpenWebIf as the default web interface. In these images some standard functionality may still work but is not guaranteed. Some features that may not function include:

• Autotimers
• Drive Space Reporting
• Embedded EPG Genre IDs
• Full Tuner Signal Support (Including Service Providers)
• Timer and Recording descriptions: If your provider only uses short description (plot outline) instead of long descrption (plot) then info will not be displayed pertaining to the shows in question. For OpenWebIf clients a JSON API is available to populate the missing data.
• Edit recording name, last played position and play count for recordings
• Bouquet (and group specific) Backend Channel Numbers

Some features are only available with at least certain OpenWebIf versions:

• 1.3.0: AutoTimers
• 1.3.5: Embedded EPG Genres, Tuner Details, Provider Name, Picon URLs
• 1.3.6: Editing Recordings
• 1.3.7: Backend Channel Numbers
• 1.3.9: Recording Sizes
• 1.4.4: Recursive Movie listing
• 1.4.6: Use internal OWF MovieList (avoids memory leak on some images)

The contents of this README.md file are as follows:

1. Build instructions
2. Support links
3. Compatibility with OpenWebIf and other WebIfs
4. Configuring the addon
   • Connection
   • General
   • Channels
   • EPG
   • Recordings
   • Timers
   • Timeshift
   • Backend
   • Advanced
5. Customising Config Files
   • Custom Channel Groups (Channels)
   • Provider Name Mappings (Channels)
   • Season, Episode and Year Show Info (EPG)
   • Genre ID Mappings (EPG)
   • Rytec Genre Text Mappings (EPG)
6. Appendix
   • Manual Steps to rebuild the addon on MacOSX
   • Logging in detail

Build instructions

Linux

1. git clone --branch master https://github.com/xbmc/xbmc.git
2. git clone https://github.com/kodi-pvr/pvr.vuplus.git
3. cd pvr.vuplus && mkdir build && cd build
4. cmake -DADDONS_TO_BUILD=pvr.vuplus -DADDON_SRC_PREFIX=../.. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=../../xbmc/build/addons -DPACKAGE_ZIP=1 ../../xbmc/cmake/addons
5. make

The addon files will be placed in ../../xbmc/build/addons so if you build Kodi from source and run it directly the addon will be available as a system addon.

As an alternative to step 4 the following command can be run whic is addon agnostic:

• cmake -DADDONS_TO_BUILD=$(basename $(dirname $(pwd))) -DADDON_SRC_PREFIX=../.. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=../../xbmc/addons -DPACKAGE_ZIP=1 ../../xbmc/cmake/addons

Mac OSX

In order to build the addon on mac the steps are different to Linux and Windows as the cmake command above will not produce an addon that will run in kodi. Instead using make directly as per the supported build steps for kodi on mac we can build the tools and just the addon on it's own. Following this we copy the addon into kodi. Note that we checkout kodi to a separate directory as this repo will only only be used to build the addon and nothing else.

Build tools and initial addon build

1. Get the repos

• cd $HOME
• git clone https://github.com/xbmc/xbmc xbmc-addon
• git clone https://github.com/kodi-pvr/pvr.vuplus

2. Build the kodi tools

• cd $HOME/xbmc-addon/tools/depends
• ./bootstrap
• ./configure --host=x86_64-apple-darwin --with-platform=macos
• make -j$(getconf _NPROCESSORS_ONLN)

3. Build the addon

• cd $HOME/xbmc-addon
• make -j$(getconf _NPROCESSORS_ONLN) -C tools/depends/target/binary-addons ADDONS="pvr.vuplus" ADDON_SRC_PREFIX=$HOME

Note that the steps in the following section need to be performed before the addon is installed and you can run it in Kodi.

To rebuild the addon and copy to kodi after changes (after the initial addon build)

1. cd $HOME/pvr.vuplus
2. ./build-install-mac.sh ../xbmc-addon

If you would prefer to run the rebuild steps manually instead of using the above helper script check the appendix here

Support links

• Kodi's PVR user support forum
• Report an issue on Github
• Kodi's PVR development support forum

Logging

When reporting issues a debug log should always be supplied. You can use the following guide: Easy way to submit Kodi debug logs

For more detailed info on logging please see the appendix here

Configuring the addon

Settings Levels

In Kodi 18.2 the level of settings shown will correspond to the level set in the main kodi settings UI: Basic, Standard, Advanced and Expert. From Kodi 19 it will be possible to change the settingds level from within the addon settings itself.

Connection

Within this tab the connection options need to be configured before it can be successfully enabled.

• Enigma2 hostname or IP address: The IP address or hostname of your enigma2 based set-top box.
• Web interface port: The port used to connect to the web interface.
• Use secure HTTP (https): Use https to connect to the web interface.
• Username: If the webinterface of the set-top box is protected with a username/password combination this needs to be set in this option.
• Password: If the webinterface of the set-top box is protected with a username/password combination this needs to be set in this option.
• Enable automatic configuration for live streams: When enabled the stream URL will be read from an M3U8 file. When disabled it is constructed based on the service reference of the channel. This option is rarely required and should not be enbaled unless you have a special use case. If viewing an IPTV Stream this option has no effect on those channels.
• Streaming port: This option defines the streaming port the set-top box uses to stream live tv. The default is 8001 which should be fine if the user did not define a custom port within the webinterface.
• Use secure HTTP (https) for streams: Use https to connect to streams.
• Use login for streams: Use the login username and password for streams.
• Connection check timeout: The value in seconds to wait for a connection check to complete before failure. Useful for tuning on older Enigma2 devices. Note, this setting should rarely need to be changed. It's more likely the Connection check interval will have the desired effect. Default is 30 seconds.
• Connection check interval: The value in seconds to wait between connection checks. Useful for tuning on older Enigma2 devices. Default is 10 seconds.

General

Within this tab general options are configured.

• Set program id for live channel streams: Some TV Providers (e.g. Nos - Portugal) using MPTS send extra program stream information. Setting the program id allows kodi to select the correct stream and therefore makes the channel/recording playable. Note that it takes approx 33% longer to open any stream with this option enabled.
• Fetch picons from web interface: Fetch the picons straight from the Enigma 2 set-top box.
• Use picons.eu file format: Assume all picons files fetched from the set-top box start with 1_1_1_ and end with _0_0_0.
• Use OpenWebIf picon path: Fetch the picon path from OpenWebIf instead of constructing from ServiceRef. Requires OpenWebIf 1.3.5 or higher. There is no effect if used on a lower version of OpenWebIf.
• Icon path: In order to have Kodi display channel logos you have to copy the picons from your set-top box onto your OpenELEC machine. You then need to specify this path in this property.
• Update interval: As the set-top box can also be used to modify timers, delete recording