Difference between revisions of "Providing TV listings"

From TV-Browser Wiki
Jump to: navigation, search
(→‎TV listings usage permit: Fixed link to german letter)
m (Reverted edits by Allensmith (Talk); changed back to last version by Jo)
 
(15 intermediate revisions by 9 users not shown)
Line 4: Line 4:
 
* Using a command line/terminal
 
* Using a command line/terminal
 
* Configuring software using text files
 
* Configuring software using text files
−
* '''Creating programs''' that read websites or other sources and convert them to other formats. The language you use to do this doesn't matter. It should be possible to use anything like VB or Java. Without such a program you would need to convert the data manually. '''We strongly discourage converting the data manually!'''
+
* Creating programs that read websites or other sources and convert them to other formats. The language you use to do this doesn't matter. It should be possible to use anything like VB or Java. Without such a program you would need to convert the data manually. '''We strongly discourage converting the data manually!'''
 +
 
 +
Download the TvDataStarterKit:
 +
* [[TV_Listings_Tutorial| Get the latest version here]]
  
 
The operating system doesn't matter, the tools are written in Java and should run on any platform that runs TV-Browser.
 
The operating system doesn't matter, the tools are written in Java and should run on any platform that runs TV-Browser.
Line 18: Line 21:
 
Alternatively, it's possible to enter and extract the data to and from an XML file.
 
Alternatively, it's possible to enter and extract the data to and from an XML file.
  
−
How this works is explained in the [[TV Listings Tutorial|tutorial]]. It also explains the other tools you need to prepare the data.
+
How this works is explained in the [http://tvbrowser.org/downloads/starterkit/index.html tutorial]. It also explains the other tools you need to prepare the data.
  
 
===Primary Data Service===
 
===Primary Data Service===
  
−
There is also the possibility of writing your own [[Primary Data Service|PDS]] that reads the data from a website or some other source. Ofcourse, to implement such a service you have to know Java programming. If you do know Java read the [http://www.tvbrowser.org/downloads/docs/providetvdata_v1.1_de.pdf guide] about how to proceed.
+
There is also the possibility of writing your own [[Primary Data Service|PDS]] that reads the data from a website or some other source. Of course, to implement such a service you have to know Java programming. If you do know Java read the [http://www.tvbrowser.org/downloads/docs/providetvdata_v1.1_de.pdf guide] about how to proceed.
  
 
====Tips====
 
====Tips====
Line 28: Line 31:
 
* [[Processing Listings  - Automatic conversion from Word/Excel to TXT/CSV using OpenOffice]]
 
* [[Processing Listings  - Automatic conversion from Word/Excel to TXT/CSV using OpenOffice]]
  
−
===TV-Data Services===
+
===TV data services===
  
−
The third way to provide your listings is to program so called [[Plugin#TV-Data Services|TV-Data Services]]. (See [[Tutorial: Development of a TvDataService]]). These will be loaded directly into TV-Browser as a [[Plugin]]. An example of such a plugin is the [[NextViewDataService]].
+
The third way to provide your listings is a program so called [[Plugin#TV-Data Services|TV data services]]. (See [[Tutorial: Development of a TvDataService]]). These will be loaded directly into TV-Browser as a [[plugin]]. An example of such a plugin is the [[NextViewDataService]].
  
 
This third possibility should only be used in special cases. The development is much more involved than for a PDS, and everyone who wants to use your service needs to install a plugin, while in the PDS case he only needs to enter an URL.
 
This third possibility should only be used in special cases. The development is much more involved than for a PDS, and everyone who wants to use your service needs to install a plugin, while in the PDS case he only needs to enter an URL.
Line 38: Line 41:
 
=== TV listings usage permit ===
 
=== TV listings usage permit ===
  
−
To be allowed to use the listings of different TV/Radio stations an official permit of the broadcasting service is needed. An example mail can be found on the [http://wiki.tvbrowser.org/index.php/Eigene_TV-Daten_anbieten#Weitere_Tipps german site].
+
To be allowed to use the listings of different TV/radio stations an official permission of the broadcasting service is needed. Here you can read an example mail
 +
 
 +
 
 +
Request for permission to use program schedules
 +
 +
Dear Sir or Madam,
 +
 +
I am a volunteer of the free electronic program guide 'TV-Browser' (for information, please see
 +
"http://www.tvbrowser.org/"). This is an open source project without any commercial interests,
 +
meanwhile we already count over 200,000 active users.
 +
 +
We wish to extend our program magazine by your [station/stations] [STATIONNAME/S]. That is why
 +
I ask you to furnish me an access to your press area or admit my address to your press
 +
distribution list and to give me the permission for preparing and providing your program data
 +
on our web servers for the users of the program guide. If your organisation does not carries on
 +
a press area or distribution list, I ask for an allowance to read out the data of [STATION URL]
 +
in the form of an automated procedure.
 +
 +
Moreover I would need your station emblem for viewing in the environment of the program
 +
information if possible and it would be nice, if you could also send me an optional permission
 +
for using program pictures within the program area of ''TV-Browser''.
 +
 +
The program data is stored at our web servers and protected against unfamiliar exploitations
 +
because of the application specific format. The user of ''TV -Browser'' gets an emphatic note
 +
about the data's rights holder. Program data of expired days gets deleted after one day so that
 +
there is no deposition chance.
 +
 +
Yours faithfully,
 +
[ABSENDERNAME]
  
 
You should use friendly, but decisive wording.
 
You should use friendly, but decisive wording.
  
−
'''Important:''' Don't forget to provide them with your name, address and phone number!
+
'''Important:''' Do not forget to provide them with your name, address, phone and fax number, if available and usable.
  
 
[[de:Eigene TV-Daten anbieten]]
 
[[de:Eigene TV-Daten anbieten]]
 +
 +
[[category:Development]]

Latest revision as of 00:07, 4 October 2011

Requirements

Required skills:

  • Using a command line/terminal
  • Configuring software using text files
  • Creating programs that read websites or other sources and convert them to other formats. The language you use to do this doesn't matter. It should be possible to use anything like VB or Java. Without such a program you would need to convert the data manually. We strongly discourage converting the data manually!

Download the TvDataStarterKit:

The operating system doesn't matter, the tools are written in Java and should run on any platform that runs TV-Browser.

Providing TV listings

There are three possibilities to get your listings into TV-Browser:

Excel/XML

We wrote a little tool to enter and extract data for one channel in a Excel sheet (we call such tools Primary Data Service or PDS).

Alternatively, it's possible to enter and extract the data to and from an XML file.

How this works is explained in the tutorial. It also explains the other tools you need to prepare the data.

Primary Data Service

There is also the possibility of writing your own PDS that reads the data from a website or some other source. Of course, to implement such a service you have to know Java programming. If you do know Java read the guide about how to proceed.

Tips

TV data services

The third way to provide your listings is a program so called TV data services. (See Tutorial: Development of a TvDataService). These will be loaded directly into TV-Browser as a plugin. An example of such a plugin is the NextViewDataService.

This third possibility should only be used in special cases. The development is much more involved than for a PDS, and everyone who wants to use your service needs to install a plugin, while in the PDS case he only needs to enter an URL.

More tips

TV listings usage permit

To be allowed to use the listings of different TV/radio stations an official permission of the broadcasting service is needed. Here you can read an example mail 


Request for permission to use program schedules

Dear Sir or Madam,

I am a volunteer of the free electronic program guide 'TV-Browser' (for information, please see
"http://www.tvbrowser.org/"). This is an open source project without any commercial interests, 
meanwhile we already count over 200,000 active users.

We wish to extend our program magazine by your [station/stations] [STATIONNAME/S]. That is why
I ask you to furnish me an access to your press area or admit my address to your press
distribution list and to give me the permission for preparing and providing your program data
on our web servers for the users of the program guide. If your organisation does not carries on
a press area or distribution list, I ask for an allowance to read out the data of [STATION URL]
in the form of an automated procedure.

Moreover I would need your station emblem for viewing in the environment of the program
information if possible and it would be nice, if you could also send me an optional permission
for using program pictures within the program area of TV-Browser.

The program data is stored at our web servers and protected against unfamiliar exploitations
because of the application specific format. The user of TV -Browser gets an emphatic note
about the data's rights holder. Program data of expired days gets deleted after one day so that
there is no deposition chance.

Yours faithfully,
[ABSENDERNAME]

You should use friendly, but decisive wording.

Important: Do not forget to provide them with your name, address, phone and fax number, if available and usable.

Retrieved from "https://enwiki.tvbrowser.org/index.php?title=Providing_TV_listings&oldid=5362"