From VDR Wiki
Revision as of 12:24, 10 January 2009 by (talk)
Jump to navigation Jump to search

This plugin parses the extended (2 to 10 day) EPG data which is send by providers on their portal channels. This EEPG data is transmitted in a non-standard format on a non-standard PID.


Currently the following EEPG formats are supported:

  • Mediahighway 1 (CanaalDigitaalNL, CSat, Cyfra+)
  • Mediahighway 2 (Digital+)
  • Sky Italy
  • Sky UK
  • Freesat
  • Premiere


Unpack, make and make plugins like any other plugin. Call like any other On the first run, in the vdr-plugins directory a subdirectory eepg is created where all necessary files are created. One can define equivalent channels in the eepg.equiv file to "copy" EEPG data to other channels. E.g., CanaalDigitaalNL still sends Dorcel EEPG data on S19.2E, which can be used for Dorcel on S13.0E. Some sample eepg.equiv files are included.


The plugin has no mainmenu entry, and only a few settings for Premiere. When one of VDR's devices is tuned to a transponder (by tuning, a recording or an EPG scan triggered by VDR), the plugin scans all channels on the transponder for one of the supported EEPG formats. When one of the supported formats is detected, all available EEPG data is loaded into the schedule of VDR. Additionally, the EEPG data is loaded into additional channels if they are specified in the eepg.equiv file (not for Premiere or Freesat). Everything is done automatically and transparently, all is done concurrently with recordings and live viewings. If a device stays tuned for more than 1 hour to the same transponder, it will automatically rescan and reload new EEPG data (for Mediahighway and SKY; Freesat and Premiere are loaded continuously).

The plugin is designed to use as less recources as possible: it only uses 1 Pid (especially important to users of FF cards, which have a max. of 32 Pids), and allocates and frees memory according to its needs.

If one needs to reload EEPG data periodically, it is sufficient to create a cron job which tunes to the proper channel through the SVDRP interface. In practice, viewing and tuning to your favourite channels reloads the EEPG data daily, which is often enough since EEPG data is valid for 2 - 10 days.

New, unknown EEPG transponders will be detected automatically (MHW1, MHW2, Freesat) or have to be added (Sky uses different huffman decoding tables for every country).

Currently known transponders that send EEPG data:

  • Sky Italia S13.0E:11881V (OpenTV)
  • Sky UK S28.2E:11778V (OpenTV)
  • Cyfra+ S13.0E:10719V (Mediahighway 1)
  • CSat S19.2E:12363V (Mediahighway 1)
  • Canal DigitaalNL S19.2E:12515H (Mediahighway 1)
  • Digital+ S19.2E:10847V (Mediahighway 2)
  • Premiere Sport Portal, Premiere Direkt Portal
  • Freesat all freesat channels


This code is based on:

  • Premiere plugin (C) 2005-2007 Stefan Huelswitt
  • mhwepg program (C) 2002, 2003 Jean-Claude Repetto
  • LoadEpg plugin written by Luca De Pieri
  • Freesat patch written by dom /at/

We wish to thank all authors for the great work they have been doing, decoding this EEPG data; this plugin tries to combine the best of all worlds. Specific improvement has been done on Mediahigway 1 protocol: all software known tries to combine titles and summaries on the basis of the event-id, but several channels can use the same event-id at the same time. This leads in practice to 20-25% erroneous summaries. The plugin uses the same technique as more simple satellite receivers, which take into account the order in which titles and summaries are sent. This leads to 99-100% accuracy. Also, the "number of replays" technique for CSAT is implemented correctly; not all software supported this information, which leads to loss of 80-90% of the EEPG information.


-Equivalents file is not used for Freesat, Premiere. -On Sky Italy and Sky UK, a lot of "summaries not found" are reported. This is

because it is not (yet) known where the "summary available" flag is coded in the
OpenTV protocol used, so all titles are assumed to have a summary available.