Nxtvepg Data

The German article 'Nxtvepg-Daten-Plugin' may have some additional appendix information.

Preface

The Nxtvepg Data Plugin imports TV data from nxtvepg, an application that reads out the Nextview EPG and the teletext pages at analog TV cards. The plugin is based on the NextViewDataService (version 1.6) from Andreas Hessel. Due to changes in the program structure of TV-Browser since version 2.0 some patches were necessary and besides new features were added.

According to present knowledege Nxtvepg Data Plugin is operating well in TV-Browser from 2.6 upward under WINDOWS XP SP2 and ME as well as under UBUNTU 7.10, and with Java 1.5 upward. Compatibity with other versions of TV-Browser (i.e. 2.2 series using Java 1.4) is not tested yet. In the 'transportable' versions of TV-Browser the plugin can be used only with some reservations, as it depends on the actual configuration of the application nxtvepg.

Installation

• Move File 'NextViewDataService.jar' to the 'Plugins'-Directory of TV-Browser.

• Restart TV-Browser.

Configuration

You will find the configuration menu for Nxtvepg Data Plugin in TV-Browser's 'Settings' menu at 'TVDataServices':

The settings in detail:

nxtvepg Application File

The full path name of the application nxtvepg.

   Windows: Default is 'C:\Program Files\nxtvepg\nxtvepg.exe'.
   Linux:   The standard application path is '/usr/bin/nxtvepg'.

The application path is a mandatory setting!

The Nxtvepg Data Plugin imports data collected by the application nxtvepg before. You have to configure nxtvepg first and nxtvepg must have filled its data base before you can import data to TV-Browser. Wether nxtvepg is running (as program or service in the background) during the data import doesn't matter.

The other settings are optional:

nxtvepg Configuration File

The configuration file for nxtvepg. If not set, nxtvepg's default is used, i.e.:

   Windows:  nxtvepg.ini in nxtvepg's application directory 
             (e.g.: 'C:\Program Files\nxtvepg\nxtvepg.ini')
   Linux:    '/home/<username>/.nxtvepgrc'

Sometimes it's useful to build a different configuration file; e.g. if only a subset of the channels nxtvepg provides is really imported to TV-Browser. Less channels in the configuration file means a faster update of the channel list and a faster update of program data.(With 'Provider' setting 'merged' only.)

nxtvepg Data Base Directory

The directory path of the nxtvepg data base. If not set, nxtvepg's default is used, i.e.:

   Windows: nxtvepg's application directory (e.g.: 'C:\Program Files\nxtvepg')
   Linux:   Normally it's  '/home/<username>/.nxtvdb/'.  
            According to the nxtvepg help file it's '/usr/tmp/nxtvdb/nxtvdb-'.
            But I have seen '/var/tmp/nxtvdb/' also.

nxtvepg Provider

Default is 'merged', i.e. the providers as they are set via 'Merge Provider' in nxtvepg. Using the drop down menu you can select a single provider. You can also select an alternative provider typing its CNI code to the text field. (Hint: The 4 character code can be found in the name of the corresponding nxtvepg data base file; e.g.: the German EPG provider Kabel1 is stored in the file: nxtv0d92.epg, the CNI code is: 0d92)

Adding Channels to TV-Browser's Channel List

After configuring and applying the settings go to 'General Settings --> Channels' and update the channel list. The channels provided by the Nxtvepg Data Plugin will show up in the 'Available Channel' list tagged with the nxtvepg icon to ease the identification.

Tricks and Traps

1. Marker and Reminder settings on programs provided by Nxtvepg Data Plugin will be removed due to a change in starting time (especially when using the teletext grabber for defining the program schedule this will happen many a time) and sometimes by no obvious reasons.
2. Updating the program data will be faster, if nxtvepg is called using a 'minimal' configuration file; i.e. only those channels (networks) are selected, which should be imported to TV-Browser. (With Provider setting 'merged' only!)
3. Nxtvepg Data Plugin doesn't keep backups of previous program data. For that reason all programs ending more than 4 hour before will be removed on update. To get older TV data from nxtvepg the default settings of this application must be changed: open menu 'Filter-->Expired Display-->Configuration' in nxtvepg and set the delay before prgrams will be removed e.g. to 2 days. Initialize the setting with 'Update' and click 'OK' to save. To display the program data in TV-Browser 2 days are sufficent, additional time will unnecessary slow down the updating process.
4. The Nxtvepg Data Plugin saves file settings with absolute pathnames. That's why the settings for Linux and Windows are stored in different properties. If the same TV-Browser setting is shared by Linux and by a Windows partition all channels are removed when the other operation system opens TV-Browser for the first time. A workaround (as described in chapter 6.2 of the German article) for that problem will be presented here as soon as possible.

Appendix

Shared Settings under Linux and Windows

The settings of the Nxtvepg Data Plugin are stored in different properties. After configuring the data plugin under operating system 'one' therefore the settings for operating system 'two' aremissing. The consequence is that all channels will be removed when starting TB-Browser under operating system 'two'. This can be avoided by manipulating the properties file of the data plugin:

Open the file 'nextviewdataservice.NextViewDataService.service' in TV-Browser's settings directory before TV-Browser is started under operating system 'two' and add the missing properties. (If you're still under operation system 'one' close TV-Browser before you open the properties file and in any case think about backing up!)

The example shows how the properties file is structured:

   settings
   Wed Jan 16 16:26:56 CET 2008

   WIN_PROVIDER=merged
   LIN_PROVIDER=merged

   WIN_PATH=C\:\\Program Files\\nxtvepg\\nxtvepg.exe
   LIN_PATH=/usr/bin/nxtvepg

   WIN_DBDIR=X\:\\Application Data\\nxtvepg
   LIN_DBDIR=/media/hda2/Application Data/nxtvepg

   WIN_RCFILE=X\:\\Application Data\\nxtvepg\\nxtv4TVB.ini
   LIN_RCFILE=/media/hda2/Application Data/nxtvepg/nxtv4TVBrc

In example above 'X:' and '/hda2' identify the shared disk. Both operating system use the same data base directory for nxtvepg but different configuration files. This may be necessary if different versions of nxtvepg are used, e.g. the configuration files of vers. 2.7.7 and 2.8 are not compatible. Anyway, both configurations should include the same networks as missing channels will be removed from TV-Browser's channel list.