Navigator Systems Ltd -Digiguide to SnapStream

This addon, for Digiguide, transfers programs which are marked as favourites, reminders or selected through smart searches into SnapStream to allow them to be recorded. The addon allows programs to be rated from 1 star through to 5 stars. In the event of a schedule clash, the program with the highest rating (5 star) takes priority.
The addon communicates with SnapStream via it's web interface, so any changes the addon makes are instantaneous. The addon can also remove programs from SnapStream, so in the event of a program being scheduled to be recorded, say a week in advance, if at a later date, you'd rather record a higher priority program that clashes, the earlier scheduled program will be removed.

Multiple Digiguides can 'talk' to one Snapstream server, so a copy of Digiguide at home and another one at work can both schedule programs on the same SnapStream server.

Use

The Digiguide Snapstream export addin, relies on programs being marked as favourites, reminders or selected through smart searches in Digiguide. Thus is I want to record this week's episode of "The West Wing", I would mark it with a reminder in Digiguide, however if I wanted to record ALL episodes of "The West Wing", I would mark it as a favourite in Digiguide. If on the other hand I wanted to record all programs starring Martin Sheen (who plays The President in "The West Wing"), I would configure a Digiguide Smartsearch along the line of "Martin AND Sheen", then programs referring to Martin Sheen would be recorded.e.g "The West Wing", "Apocalypse Now", "Film 2001 with an interview with Martin Sheen".

To export the programs from Digiguide to Snapstream either right click in Digiguide's planner view and select "Run SnapStream Export", or even simpler, select "Configure Snapstream Export" and schedule the export to run automatically everyday.

Installation

Installation is straightforward. Download the file digi_ssw_install.exe and run it.
The installation program places two files in your Digiguide directory (ssw_dg.exe and dsr_snapstream.dgaddin) and five files in your Windows/System32 folder (nmocod.dll, NMORENU.DLL,. NMSCKN.DLL, NMW3VWN.DLL, html.ocx).
Using the Add/Remove programs feature of the windows control panel, the whole addon can be removed.

Digiguide MUST be restarted after the addin is installed.

The addin has been tested with Digiguide 5 build 150 and SnapStream 1.1a. Previous versions may work, but are not supported.

NOTE FOR DIGIGUIDE 6 USERS: Due to a couple of changes in the way digiguide 6 works, you also need to download dsr_snapstream.dgaddin and manually copy it to you digiguide folder. This must be done after the above installation and before re-running digiguide.

Configuration

Before using the addin for the first time it must be configured.

Right Click on your Digiguide planner view.

popup.jpg (18436 bytes)

Select "Configure SnapStream Export". The following dialog will be displayed.

config.jpg (34267 bytes)

IP Settings

SnapStream Server IP - This is the IP address of your snapstream server.
Port - The Port used by SnapStream, the default is 8129.
Run Internal Web Server on port - In order to talk to SnapStream, the addin creates it's own hidden Web Server. Unless you have good reason, there is no need to change from the default 8100.

Export Settings

If Digiguide is running Run Export at - If the checkbox is checked then the export from Digiguide into SnapStream will run everyday at the selected time.
Export Today plus 0 extra days - By default Digiguide exports only the current days programs. Increasing this setting will increase the number of days that are exported each time the export runs.

Program Settings

If programs overlap I don't mind missing the first 0 minutes - If two scheduled programs overlap by less than the  number of minutes stated then the begining of the second program will be chopped off to accommodate both programs.
If programs overlap I don't mind missing the last 0 minutes - If two scheduled programs overlap by less than the  number of minutes stated then the end of the first program will be chopped off to accommodate both programs.

Mapping Digiguide Channels to SnapStream Channels.

In order for the addon to know which Digiguide channels relate to which SnapStream channels, the SnapStream channel number must be entered in Digiguide.

In Digiguide, Click on "Change your Channels"
In the Your Chosen Channels box (box 3), select a channel which is to be available to the addon.

Channels.jpg (27681 bytes)

Click on the "123" label.
In the "Edit a Channel Assignment" box, enter the SnapStream channel number.
In the above example BBC2 is allocated to SnapStream Channel 2.

If a channel has no identifier assigned against it, then it will not be exported e.g BBC Radio One has not had an identifier set so will not be exported

Rating Programs

To rate a program, right click on the program in Digiguide's planner view.

popup.jpg (18436 bytes)

Select the menu item to "Rate as" the desired number of stars.
The "Current Rating is" menu option displays the current rating for that program, but clicking on it has no function.

Running the Export

To run the export, right click in Digiguide's planner view and select "Run SnapStream Export". Alternatively you can set a scheduled export using the configure option.
The export program export1.jpg (7513 bytes) will be displayed whilst the addon is exporting data to SnapStream.

To see what is happening this dialog can be expanded.

export2.jpg (37214 bytes)

The top box displays a log of the actions the addin is processing. The bottom box is a web browser window which is used to talk to SnapStream.
The items in the log box are also written to the file digi_ssw.log in the digiguide directory. Note this file is never trimmed, so should be manually deleted from time to time.

Note: The addin rewrites the files ExportTemplate.txt and export.ini to it's own format.

Known Problems

The Current version does not support SnapStream passwords. Your SnapStream server MUST have password access turned off.

Only the first 150 characters of the Digiguide description are transferred to SnapStream.

Support and License

This product is available free of charge subject to our standard license conditions which may be viewed here. There is no copy protection system in use by this software.

Support is available via e-mail only. mailto:digisnap@navigator.co.uk