Distributed Universal Guide Grabber
Version 2.5
The program comes packaged in a .zip file that should contain the following
dugg.ini
dugg.tkn
dugg.exe
dugg-instructions.html
version-info.txt
VGUI31W.SLL
VOFLR31W.SLL
VTHK31W.DLL
VTK1631W.DLL
VTK3231W.DLL
VVM31W.DLL
VVMT1W.DLL
ftp4w32.dll
If your package does not contain all these files, someone has messed with it.
The program does not require "Installation" in the conventional sense.
Simply extract all the files to a single directory of your choice.
The program needs to create temporary wotking directories and files so choose a directory for which you have write access.
The once extracted, you need to edit the dugg.ini file. This file contains all the details the program needs for your specific setup. The default setup will work for users of media-portal in Sydney getting free-to-air data but most users will need to make some kind of customization to this file. To edit the file open it with notepad or wordpad. In most cases Windows will do this automatically anyway when you double-click it.
The file dugg.ini contains customization data for the program. Each element is described below.
crypt=XXXXXX
I don't plan to explain this, other than to say don't change it.
This instruction is a safeguard and will only need to be changed if a major problem occurs with the program's internet resources.
Unless given specific instructions, leave it alone.
grabdays=X
This tells the program how many days of data to grab in advance.
It is a single digit, and the maximum number available is 10. If there is no data available for a particular day the program will skip it, and try the next day.
Note that a "day" starts and ends at midnight. This is different to version 1.0 which ran from 6 AM to 6AM.
service=XXX
This tells the program which "services" to grab.
A service refers to a bundled set of TV channels and for most users it is determined by their location.
If you get pay-TV this is another service also.
The program can grab up to 30 services but most users would have just 1 or 2.
Add each service on a new line.
See the bottom of this page for numbers of the various services.
So, for example if you add :
service=73
service=124
service=168
The program will grab free-to-air Sydney, Optus and Foxtel Digital data.
xmldir=filepath
This tells dugg where to store the XML program guide data.
It must be a valid path and the user must have write access to this directory.
The program defaults to the path most commonly used by Media Portal, as below.
xmldir=C:\Program Files\TeamMediaPortal\MediaPortal\xmltv\
tmpdir=filepath
This specifies a directory for the program to create temporary working files. The default is below
tmpdir=C:\tmpdir\
xmlname=filename.xml
This specifies the name of the XML file created that contains guide data. Default is below.
xmlname=tvguide.xml
timezone=XXXXX
This sets the default timezone offset. It must be 5 characters long. The first character is a "+"or "-" and the next 4 are the time offset from Grenwich Mean Time in 24 hour format. Note below there is the ability to set special timezones to specific services. The vast majority of users can just leave the default, which is :
timezone=+0000
rating=XXX
This instruction is required by Windows Media Center Edition and is only included for potential future use. I suggest you leave the default.
rating=ABA
message=type your message here....
This instruction allows users of the program to send a message back to the author. The message must be a single line but can be of unlimited length. The message will be uploaded to a secret location in encrypted format. If you want a reply, include your email address somewhere in the message. An example is below.
message=This is a cool program and someone should give you lots of money. Love billgates@microsoft.com
NOTE that if a message is present, DUGG will not grab any data. It will only upload the message, so after sending once, remove it from the ini file and continue to use as normal.
skip=channelname
The skip command instructs the program not to include this channel in the guide data. Most users with pay-TV if they do not subscribe to a particular channel should include a skip command for that channel. You can add up to 200 skip commands and each one should be on a new line. Note that the channelname is case sensitive and must be spelled exactly correct or it will not work. For example :
skip=BBC WORLD
skip=SKY RACING
Will mean that any data for BBC WORLD and SKY RACING will not appear in the final guide data.
channehswap
This command lets you rename channels to your liking.
Each entry consists of 3 lines, the first of which is always channelswap.
The next line is the name of the channel you want to rename.
The next line is the new name you want to give it.
channelswap
Channel Nine Brisbane
Channel 9
The above would rename "Channel 9 Brisbane" to "Channel 9"
You can add up to 200 channelswapss and each one must have 3 lines, as above.
Note that it is CaSe SensitivE and you must spell the channel exactly correctly.
channeldupe
This command lets you duplicate a channel. Use it for when you get the same programs on different channels. The most common reason would be where you get simultaneous analog, digital and/or high definition transmissions and you want to distingguish them. So for example if "Channel Nine" comes in digital and analog, just add this command.
channeldupe
Channel Nine
Channel Nine Digital
You can create a third entry by duplicating again..
channeldupe
Channel Nine
Channel Nine High Definition
This will result in 3 channels, (Channel Nine, Channel Nine Digital and Channel Nine High Definition) all having the same program data.
If you wanted you can then rename the original channel using channelswap.
channelswap
Channel Nine
Channel Nine Analog
But make sure any channelsdupe commands come before channelswap.
specialtimezone
If you grab more than 1 service it is possible that they are in different timezones.
By default all services will use the timezone specified in the timezone= command but you can over-ride this by allocating a special time zone.
The command takes this format :
specialtimezone
Service number
Timezone for this service
So for example
specialtimezone
168
+0300
Would allocate the timezone "+0300" to channels in service number 168 (Foxtel Digital)
You can add up to 30 special time zones and each one should consist of 3 lines, as above.
verbose
This single line, single word command instructs the program to make a more detailed log of its operations. It is useful for debugging and fault-finding but beware the log files can get big. The command simply is placed somewhere in the file like :
verbose
Below is a list of Australian regions and the number used for their service.
The various Pay TV providers also have service numbers.
FREE TO AIR
63 = Broken Hill
66 = Central Coast
67 = Griffith
69 = Northern NSW
71 = Southern NSW
73 = Sydney
74 = Darwin
75 = Brisbane
78 = Gold Coast
79 = Regional QLD
81 = Adelaide
82 = Renmark
83 = Riverland
85 = South East SA
86 = Spencer Gulf
88 = Tasmania
90 = Eastern Victoria
93 = Geelong
94 = Melbourne
95 = Mildura/Sunraysia
98 = Western Victoria
101 = Perth
102 = Regional WA
106 = Remote & C'tral NSW
107 = Remote & C'tral SA
108 = Remote & C'tral NT
114 = Remote & C'tral QLD
126 = ACT
184 = Newcastle
PAY-TV
123 = Foxtel
124 = Optus
125 = Austar
168 = Foxtel Digital
169 = Austar digital