By Julian Cable.
DGgirder is an add-in for the DigiGuide EPG (version 4 or above) which enables functionality to be added using the Girder automation program. Girder lets you automate just about anything and specialises in IR Remote Control (input and output), etc.
The girder.ini file is provided because, although ini files are obsolete, its easier to edit an ini file than a registry key. The ini file allows you to specify what events to send to Girder and what context sensitive menus you want.
These sections allow marker specific events to be sent. Use the marker number as the key and the event as the value.
| [ReminderFired] | Specifies events to send when a DigiGuide reminder event occurs |
| [Start] | Specifies events to send when a programme start event occurs |
| [End] | Specifies events to send when a programme end event occurs |
| [OnNow] | DigiGuide creates an event every minute for each programme currently showing in any configured channel |
Marker Types are determined by the Digiguide template files but these are standard:
| 1 | Favourite |
| 2 | Reminder |
| 4 | Video |
| 5 | Watch |
| 6 | Category |
| 2147483646 | Manually Created |
Marker type 0 is never generated by Digiguide and is used as a wildcard by the addin.
The example shows setting a event to be sent if the Favorite Marker ( 1 ) is attached to a programme when it starts and an event to send when ANY programme ends:
[Start] 1=FavoriteStarting [End] 0=ProgrammeEnding
These sections allow menu items to be added to the Digiguide Context Menus. In these sections, X = 0..9. Keys must be used in order and in pairs.
| [ChannelMenu] | |
| MenuX | Specifies the text for the channel context menu item. |
| CommandX | Specifies an event to send when the menu item is clicked. |
| [ProgrammeMenu] | |
| MenuX | Specifies the text for the programme context menu item. |
| CommandX | Specifies an event to send when the menu item is clicked. |
The event specifications above are actually Girder event strings. The add-in adds the Digiguide API parameters as payload strings.
| [ChannelMenu] section | |
| pld1 | The channel Name (text) |
| pld2 | The Channel Assignment (text, but usually a number) |
| [OnProgramme] [ProgrammeMenu] [Start] [End] [ReminderFired] and [OnNow] sections | |
| pld1 | The channel Name (text, enclosed in quotes) |
| pld2 | The Channel Assignment (text, usually a number) |
| pld3 | The Programme Name (text, enclosed in quotes) |
| pld4 | The Start Date & Time as HH:MM DD/MM/YYYY |
| pld5 | The Duration in Minutes (number) |
| pld6 | The Programme Description (multi-line text) |
| pld7 | The Programme Category (text) |
| pld8 ... | A list, possibly empty, of pairs of numbers as one string with a space between the numbers, the first number is the Marker Type and the second is the marker ID.** |
Note:
* DigiGuide version 5 and up.
** DigiGuide version 6 and up.
Here is an example girder.ini file and a GML file which shows the basics. Put the girder.ini file in the Digiguide main folder and load the GML file into Girder. Right click on a channel or programme and click on the OSD menu and a girder simple osd should come up.
First posted with bugs : 29/12/2002
v1.0 : 3/1/2003
v1.2 : 15/3/2003
The source code and build instructions are available here.
Get it here.