WebEPG

Activation

To enable or disable this plugin navigate to the Plugins section. Make sure you tick the WebEPG checkbox in the right pane or else the plugin will not be activated.

Note: Mediaportal 1.0.2 has a seperate configuration configuration utility in \program files\Team Mediaportal\Mediaportal\webEPG-conf.exe

[the location may be different, depending on where MediaPortal is installed]

General

Expand the Plugins node and select the WebEPG node in the tree, you should see the following screen:

First configure the Global Settings:

• Grab Days

• You can define the number of days you want to download program data for by specify this number in the Grab Days box. Be aware that you can not download more days than your data sources provide (you can see this amount in the Guide Days box for each channel), and that specifying more days means an increase in the amount of time it takes to download your whole guide.Enter the number of days to grab each time WebEPG runs.

• Write programs to

• Grabbed EPG data can be written to one of the following locations:

  • TV Server Database

  • This is the default option. Data will be written directly to the TV Server database and be available immediately in the TV Guide in MediaPortal. Under normal circumstances this is the option you want to select.

  • tvguide.xml file configured in XmtTv Importer Plugin

  • Some times you may need a tvguide.xml file for use with some other component. If you have configured XmlTv Importer Plugin to monitor and import a tvguide.xml file, this option allows you to output grabbed EPG data to that file for further processing.

  • tvguide.xml in the following folder

  • This is similar to the previous choice but allows you to manually specify the folder where tvguide.xml should be stored. Note that this folder should contain a copy of the xmltv.dtd file.

• Delete old programs before import (Recommended!)

• If you select this option, existing programs in the database will be removed prior to importing grabbed EPG data. This is useful if for example some EPG data has changed since the last grab. If not selected, no data will be grabbed for programs already in the database. This option only makes sense if writing EPG data directly to the TV Server Database.

• but only if new programs overlap (Recommended!)

• In some cases there might be transient network failures, the site containing the EPG data may be down. In such a case, if you have selected the previous option, you will end up with an empty TV Guide. Selecting this option will ensure that old program data will be removed only if there are newly grabbed program data to replace it. This alleviates the problem at the expense of occasionally having stale EPG data.

After the above basic configuration you may want to try to automatically map TV Server channels to grabbers known to WebEPG. To do this, select your country in the Country dropdown list, and then click the Auto Map button. The Auto Map function will first import TV Server's TV and Radio channels and then will try to find a grabber for each imported channel based on its display name. When several data sources are found for a channel, the first one will be used. Note that if the list in TV or Radio Mappings page is not empty, Auto Map will not import the channels but instead try to auto-map channels already in that list.

If auto-mapping fails to properly map you channels, or you have many channels but don't want to map all of them, you can proceed with manual mapping.

After you have successfully mapped your channels you may save your configuration by pressing the Save button. To test your configuration you may press the Grab now! button and monitor the grabbing progress on the left.

Manual Mapping

There are two configuration pages that allow you to manually map channels to WebEPG grabbers: one for TV and one for Radio channels. Only TV Mappings is described below but Radio Mapping is identical. Click on TV Mappings or Radio Mappings tab to bring up the following screen. Note that in this description the TV Mappings part is used, the Radio Mappings part is mostly the same, just for radio.

To manually map channels, first you have to import them from TV Server database. To do so just hit the Import button. If you do not want to import all of your channels, you may select a channel group in the Group dropdown list before pressing Import. You can repeat this process to import as many channel group as you need. If you want to remove some channels from the list, select them and then press the Remove button.

• If you have already selected your country from the dropdown list in the General page, you can press the Auto Map button at any time to try to automatically map the channels in the list. Existing channel mappings will not be changed, only unmapped channels will be considered for auto-mapping.

• To manually assign data sources to a channel, select the channel to configure and click the ... (browse) button behind the Channel textbox on the right side of the window. A Selection dialog will show up now. Fold out the Web Sites item, and then fold out your country item.

  • 

  Choose one of the available data sources, and select the channel from this list. If the channel is not available in the list, it may be available in one of the other data sources, or else underneath one of the other countries, if it is a foreign channel. If you still cannot find your channel listed, you may need to edit or create a new Site Configuration/Grabber File. See customizing WebEPG for details. Click the Select button to assign the data source to the channel. You do not need to close the selection window yet. Just move it to the side a bit, and click one of the other channels in the underlying TV Mappings window. Then repeat the previous procedure to assign a data source to this channel. After you've assigned all channels, you can Close the window.

• Some channels show more than one TV station, switching halfway the day from one station to the other. To configure these channels, click the Multiple (Merged) tab to bring up the screen below. Each row in the grid represent one section of the day.

  To start an new section click the ... (browse) button in the last row (which is marked with a *) to assign a data source. But now you also need to enter a starting and an ending time for the part of the day on which this station shows. To do this move to the right and type the Start and End time in the corresponding columns. Then move to another row to store you changes. Note: there is currently a bug in WebEPG which drops the first item that starts exactly at the switching time. To work around this bug, just set the starting time one minute earlier. If the switch happens as 19:00, just enter 18:59 as the starting time. You don't have to do this for the ending time. Repeat this process for each TV station that shows on this channel. To change the data source for a section, just click the ... button in the respective row. To change the Start or End time just select it and type the new time. To remove one or more sections, select the rows and press Delete on your keyboard.

• 

Schedule

Normally you want WebEPG to regularly download EPG data so that your TV Guide is always up to date. If you are using Power Scheduler plugin on the server and have configured there a schedule for grabbing EPG, WebEPG will follow that schedule. There are however situations where you are either not using Power Scheduler or you may not want to configure a schedule there. In this case you can configure when WebEPG downloads EPG data in the Schedule tab:

Here you can choose at which days of the week EPG is downloaded and at which time.