tv_grab_py_API

xlmtv API based on JSON datafiles


Keywords
data-retrieval, grabber, python, retrieve-data, xmltv-data
License
GPL-2.0+
Install
pip install tv_grab_py_API==1.0.7

Documentation

tvgrabpyAPI

Goto the WIKI

New version 1.0.7 release based on DataTreeGrab module v1.4.0

17-05-2017 (dtg 1.3.3) With a significant speed increase of in my use case 30% (from 68 minutes to 48 minutes) 10-07-2017 (dtg 1.4.0) With now an even larger speed increase of in my use case 65% to 23.5 minutes (1.72 sec/page)

Summary

tv_grab_py_API is an API for creating xmltv compatible tv grabbers. It is the succesor of tv_grab_nl_py version 2.2 making all of its functionallity available to the rest of the world.

Requirements

Installation

  • Especially under Windows, make sure Python 2.7.9 or higher is installed
  • Make sure the above mentioned Python 2 packages are installed on your system
  • Download the latest release and unpack it into a directory
  • Run:
    • under Linux: sudo ./setup.py install from that directory

    • under Windows depending on how you installed Python:

      • setup.py install from that directory
      • Or: Python setup.py install from that directory

      (the frontend script(s) will install into C:\Program Files\Python27\Scripts)

  • Run the frontend (presently only tv_grab_nl3.py) with --configure
  • Check the created configuration file ~/.xmltv/tv_grab_nl3.conf and activate the desired channels.

Some features

  • No need for anybody who wants to create a grabber to know much about Python. You mainly must write one or more json data_defs defining one or more sources. These are DataTreeGrab data_defs with some specific extensions.

  • All retrieved data is stored in an sqlite database which:

  • speeds up data retrieval

  • makes it possible to repeatetly access the data again while off-line

  • Extensive list of user-settable options to give a user maximum oportunity to adapt the program to his or her need.

  • User setable genre translation tables with developer settable defaults.

  • Multiple language support (currently English and Dutch).

  • data_def updates are automatic.

  • theTVDB.com lookup.