|
Article |
| Enable your Web Based Program Guide with XMLTV and SnapStream
Beyond TV 3 |
Posted:
September 02, 2003
|
By: Percy Bell |
|
Intro
Although Beyond TV 3 does not yet natively support integrated
TV listings for countries other than the United States, users in certain
foreign countries can use XMLTV. Previously, this only offered Program
Guide data in full-screen or windowed mode, but now, with the help of
Beyond TV "Power User" PeterOA, you can now access,
schedule, and search recordings over the Internet with his "ASP-based
EPG for Snapstream XMLTV Data" application.
XMLTV
The first part of the process is converting the XMLTV data into a format
Beyond TV 3 can use. XMLTV is an open source project
that retrieves TV listings from various sources and saves it in a
specified file format. This file format must then be imported into
the Beyond TV 3 database via a third-party application.
If you are unfamiliar with XMLTV import process then read my article
on
How to use XMLTV with SnapStream
Beyond TV 3 .
Installation and Setup
What Do I Need?
Internet Information Services (IIS) 4.0 or Greater
IIS comes with Windows 2000, Windows Server 2003 or Windows XP Professional
XMLTV:
http://sourceforge.net/project/showfiles.php?group_id=39046
XMLTV Importer:
http://forums.snapstream.com/vb/showthread.php?s=&threadid=7203
ASP-based EPG for Snapstream XMLTV Data:
http://www.snapstream.com/download/ss_asp_epg.zip
The SS_ASP_EPG.zip file contains the following:
guide.asp - EPG including browse and search
prog.asp - send selected job to SS for recording
SS_Beyond TV_DB.mdb - a blank SS database with NO PASSWORD
1x1.gif - spacing image for layout
readme.txt - instructions, etc.
How to Install
Since IIS is required for the correct operation of the ASP-based
EPG, the steps necessary for setup on Windows
2K/XP operating systems are covered.
Step 1: Download all necessary files.
Step 2: Get IIS installed.
To add ISS:
Go to Control Panel-> Add Remove Programs-> Add/Remove Windows
Components-> Internet
Information Services(IIS)
Step 3: Transfer XMLTV to Beyond TV.
This multi-part step consists of:
- Installing XMLTV
- Getting XMLTV Data
- Installing the XMLTV Importer
- Importing XMLTV Data into Snapstream
This setup procedure is covered in the Community Article:
How to use XMLTV with SnapStream Beyond TV 3
Step 4: Copy ASP pages to an IIS accessible page.
I used the directory C:\Inetpub\wwwroot\guide\.
Copy these files from the SS_ASP_EPG.zip into
that directory:
- guide.asp
- prog.asp
- 1x1.gif
Step 5: Copy the Beyond TV 3 blank database
to the appropriate location.
In order to access the data stored in the Beyond TV
3 database (SS_PVS_DB.mdb) you
must use a blank database without a password.
This is provided
in the SS_ASP_EPG.zip file.
Copy the SS_PVS_DB.mdb file to C:\Documents and Settings\All
Users\Application Data\SnapStream\Beyond TV
Step 6: Setup ASP pages to
access Beyond TV 3 data.
Guide.asp Settings
Open the guide.asp page in a text editor.
You will see something like this at the top of the file:
' HTML Guide for SS data
'
' Available Internal Parameters:
'
| timeoffset
= 6 |
'
time offset from GMT |
| defminchannel
= 2 |
' default starting
channel |
| defmaxchannel
= 56 |
' default ending
channel |
| DSNPassword
= "" |
' DSN password
for SS |
| DSNName = "SS_PERSONALVIDEOSTATION_DATABASE" |
' System DSN
Name |
| viewhours =
2 |
' number of
hours to see |
|
The timeoffset value I used is for Central Daylight Time.
The actual GMT classification for CDT is -6 GMT.
You can get your GMT offset by using Window's Date and Time Control
Panel Applet.

The defminchannel setting
is the default minimum or starting channel.
The defmaxchannel setting
is the default maximum or ending channel.
Leave your DSNPassword blank.
Leave DSNName as it is.
The viewhours settings is the number of hours that the grid will
show at a time.
Prog.asp Settings
Open the prog.asp page in a text editor.
You will see something like this at the top of the file:
| ' proxy to send programming request to jobs.cgi
'
' defaults used (change if needed):
'
strProfile
=
"a87d9660-25f0-426a-a6ab-6774842b6283" |
'
MPEG-2 "Good" profile |
| strFileFormat
= "5" |
' MPEG - WMV
is 3 |
| strStoreDest
= "Common" |
' Destination
Store of file |
| strMasterDevice
= "Cable" |
' type device |
| DSNPassword = "" |
' DSN password
for SS |
| DSNName = "SS_PERSONALVIDEOSTATION_DATABASE" |
' System DSN
Name |
| HostName = "snapstreampc" |
' SS Host Name |
| timeoffset =
6 |
' time offset
from GMT |
|
The strProfile setting
is the Globally Unique IDentifier (GUID) for the Beyond TV 3 "quality
profile" you want to use.
GUIDs for custom profiles can be found in:
C:\Documents and Settings\All
Users\Application Data\SnapStream\Beyond TV\ProfileCollection.xml
GUIDS for MPEG Default Quality Profiles
Quality Profile
|
GUID
|
Fair
|
c721c710-e307-435f-877a-14664b4518e0
|
Good
|
a87d9660-25f0-426a-a6ab-6774842b6283
|
Better
|
1beb27b8-f2d2-4f59-a4c1-52691c83d854
|
Best
|
4fcaeff4-5e3a-473b-9d20-d29ffd136469
|
NTSC
DVD Ready Low-Res
|
5b5a2160-914c-4cf3-a9d0-bb15e48e8566
|
NTSC
DVD Ready Hi-Res
|
8eb2a315-84a3-46d9-bb80-928669344fe1
|
PAL
DVD Ready Low-Res
|
493a49d5-a6f9-4258-a8dd-34100dc3527e
|
PAL
DVD Ready Hi-Res
|
104290f6-080d-4685-838a-d7db631a90db
|
GUIDS for some WMV Default Quality Profiles
Quality Profile
|
GUID
|
28.8
Modem
|
58bb58a6-f7a6-49fe-9249-894c5f41c9f9
|
56K
Modem
|
3868422b-4891-4466-bd6b-4286e97e6534
|
Single
Channel ISDN
|
e792bafb-445e-4526-a9d3-fc4bfc0ce3f1
|
Dual
Channel ISDN
|
b5c73d85-53fd-4be3-a98f-ac6eecdbbb0a
|
Cable/DSL
Low
|
6a2dfd53-a45d-4a1f-97b5-f9a09d97fc6d
|
Cable/DSL
Medium
|
17d44462-e488-48e4-8ff5-a4dd3ae184fe
|
Near
VHS
|
ce2e13b6-b350-4a09-96ce-d886ccd4fc0c
|
VHS
|
369385f5-a0ae-4011-a9b6-7ccc2e6e2874
|
|
Near
DVD
|
43f72c66-1d37-4b27-8eb7-4875bf2983c8
|
The strFileFormat setting
specifies if the recordings are going to be WMV or MPEG.
File Format
|
Value
|
MPEG
|
5
|
WMV
|
3
|
The strStoreDest setting
is the name of your Video Folder for your recordings.
The strMasterDevice setting
is the Video
Source for your recordings.
You can see the available video
sources by going to Configure->Advanced Settings->Video
Sources via
the Web Admin interface.
Leave your DSNPassword blank.
Leave DSNName as
it is.
Set your HostName to your localhost name.
You can get this by going
to Start->Run
Type cmd and press Enter.
At the command prompt type "ipconfig /all" and
press Enter.
Locate the line with your hostname on it:
Host Name . . . . . . .
. . . . . : snapstreampc
Use the same timeoffset value
you used in the guide.asp file.
Step 7: Setup Beyond TV 3 to use your
EPG.
Start the Web Admin and choose Configure -> Snapstream.Net->
Third
party Program Guide. Check the box marked "I
want to use my own..."
Use http://localhost/guide/guide.asp
NOTE: Use the localhost you entered above.
Make sure you disable automatic updates.
Allow Automatic Updates -> Disable Automatic Updates

Step 8: Schedule Recordings!
Now, with this ASP-based EPG, you can search your EPG listings and
schedule "Record Once" recordings. For those who have to
use XMLTV, this is a great way to remotely schedule recordings!
Guide Screenshot

Search Screenshot

Like this article? Want to see more? Discuss it in our forums.
|