readme.txt

XOT: XBMC Online TV Framework

* Added: Progressbar information while opening
* Added: complete contextmenu support (used AMT for inspiration but changed a lot). Menu
  is triggered by the Info Key/Button
* Changed: renamed skin xml files to uzg-windowname.xml ("uzg-" added)
* Added: ClearityMod skin
* Fixed: MC360 skin
* Changed: only importing common.py and controls.py for others a link to the object in __main__ is used.
* Added: config.py with all config stuff
* Added: controls.py with all control and window ID's
* Changed: Joox download enabled. Defaults to Cache Dir and uses item name as filename.
* Changed: moved first load of www.uitzendinggemist.nl from default.py to chn_nos.py and 
  added cookie check to chn_nos.py.
* Fixed: integer instead of float value to progressbar dialog (float is decrepated)
* Fixed: Minor bug playing KK streams 
* Changed: logging now happens in the 'uzg.log' file in the script folder of UZG. The 
  logfile from the previous session is named 'uzg.old.log'.
* Added: MultiLine Logger Class with Exception Handling
* Changed: NOS Search now accepts multiple characters.

Changelog v2.6.1 - 2007-06-20 ****Needs at least XBMC revision R8683****
* Added: Joox Support
* Added: Version Checking
* Changed: UriOpener now has False as default. Only True on data retrieval
* Fixed: Skin list scrolling

Changelog v2.6.0 (final) - 2007-06-12 ****Needs at least XBMC revision R8683****
* Fixed: uriopener did not open file if filesize was smaller than chucksize
* Changed: cleanup of uriopen method. Also adding more debuginfo
* Changed: ListItem methodes to comply with XBMC R9198
* Fixed: wrong tag in skin XML-Files
* Fixed: re-initialisation of episode window after video playback
* Fixed: MC360 skin
* Changed: New Skinlayout, first draft
* Fixed: Initialisation of Talpa-window continued even when login failed.
* Added: The "Concept" skin.
* Fixed: Errors due to very large amounts of URL's queueing up when scrolling an episode list
  fast.
* Added: Talpa.tv Uitzendinggemist Support(READ 4.a below)

Changelog v2.5.2 - 2007-05-17 ****Needs Recent Version of XBMC with WindowXML support****
* Fixed: Problem with image-links in Default skin. Prevented correct display of images
  when the default skin was selected.
* Added: PMIII skin.

Changelog v2.5.1 - 2007-05-16 ****Needs Recent Version of XBMC with WindowXML support****
* Fixed: RTL 4,5&7 streams were not working due to server changes at RTL.
* Fixed: Pixel column at left side of button removed.

Changelog v2.5.0 - 2007-05-14 ****Needs Recent Version of XBMC with WindowXML support****
* Added: initial MC360 skin support (Still needs testing)
* Changed: More NOS Uitzendinggemist history. All episodes present on the site should now 
  be visible. 
* Fixed: cleaning of URL with & insided the url
* Added: common.py has ID's for the used controls defined in channelwindow.xml
* Added: windowxml skinning support (See further down for more notes)
* Changed: icons for channels/episodes
* Changed: more robust checking for streams in Kanalenkiezer. Html is now filtered out 
  before playback (had to check HTTP first) to prevent problems with mplayer.
* Changed: location of constants changed to the channel-libary files
* Changed: all constants in CAPITALS, variable in camelCase and methodes in PascalCase

Changelog v2.4.x - 2007-04-24
* Changed: to make things a bit more easy to maintain I changed from a single default.py 
  to multiple files.
* Added: seperate python scripts for libraries (libs), channels and a default.py.
* Changed: each channel has it's own python file with instructions.
* Fixed: on some systems the Cache dir was not present which prevented the script from 
  running! Checking this now on startup.
* Added: BETA support for www.kanalenkiezer.nl
* Changed: search algorithm for www.uitzendinggemist.nl

Changelog v2.3.x - 2007-04-04
* Fixed: lookup string was wrong due to missing Q, X and Y.
* Fixed: no episodes were displayed if no date was found for episodes. 
* Added: searching NED1,2&3 Using the first letter of a program!

Changelog v2.2.x - 2007-04-04
* Added: progressbar to indicate the opening of URLs

Changelog v2.1.x - 2007-04-04
* Fixed: scaling when using HD resolutions
* Added: parsing of ASX/ASF for compatibility with older XBMC versions
* Added: first support for RTL 4,5 & 7 (please use the XBMC forum link to let me know if
  there are bugs)
* Added: icons for folders/video-files

Changelog v2.0.x - 2007-03-30
* Added: animations
* Changed: tabs instead of spaces for indentation
* Added: readme.txt
* Fixed: now again working with www.uitzendinggemist.nl
* Fixed: working ASF streams
* Added: support for multiple episodes of a programm
* Changed: split window-class into to parts: program-window and episode-window
* Added: new background
* Changed: layout
* Fixed: display most recent programms, instead of the first in alphabetical ranking

--------------------------------------------------------------------------------------------
 3. Skinning
--------------------------------------------------------------------------------------------
For future version of Uitzendinggemist.v2 a build that supports WindowXML is required. Such
a version can be found at the *ussual places*. 

For Developers: New skins need to follow these guidelines to function correctly:

* A skinfolder must be placed inside the folder 'skins'
* Uitzendinggemist uses the same folder-name to lookup the skin as the foldername XBMC is 
  using. So the skinfolder for Uitzendinggemist.v2 should have the same name as the folder 
  in which the XBMC-skin is present. E.g. for MC360: the XBMC skin-folder for MC360 is 
  called 'MC360'. So the folder that holds the skin for Uitzendinggemist.v2 should also be 
  called 'MC360' and should be located in the '<scriptfolder of uitzendinggemist>\skins\' 
  folder (which is usually scripts\uitzendinggemist\skins\'.
  If no identically named folder is found. The skin located in the 'Skins\Default' folder 
  is used.
* Inside the skin-folder should at least be a 'Media' and 'PAL' folder. The Media folder 
  holds all the images and the PAL folder the XML for the PAL oriented skins (See XBMC 
  Wiki for more info on skinning-folders).
* The XML files that need to be present are called 'progwindow.xml' and 'channelwindow.xml'. 
* IMPORTANT: Never remove the items which have ID's. These are mandatory for the script. 
  Their appearance can be changed. But they may NEVER be removed. They should keep their ID's. 
* The 'progwindow.xml' holds all the layout for the main window from where the channels
  can be chosen.
* The 'channelwindow.xml' holds all the layout for the episode windows. This is the windows
  from where you can select the episodes.

If you have made a skin, please mail it to me at uitzendinggemist.vx[@t]gmail[d0t]com so 
it can be included in future releases.

--------------------------------------------------------------------------------------------
 4. Known Limitations
--------------------------------------------------------------------------------------------
* Older XBMC builds do not completely support playing of ASF playlist files and streaming 
will fail. Updating to a more recent build of XBMC will solve the problem.
* Not all Kanalenkiezer channels are working. This is a limitation of the www.kanalenkiezer.nl
website. It cannot be fixed. I can override stream-urls. But therefore I need the correct 
URL's for the stream. You can mail them to: uitzendinggemist.vx[@t]gmail[d0t]com with a clear
description of the channel and stream URL.

--------------------------------------------------------------------------------------------
 4.a How to get Talpa working???
--------------------------------------------------------------------------------------------
Very simple. Edit the chn_talpa.py in the 'channels' folder. Somewhere in the top lines
you will find this part: 

# ONLY EDIT THESE TWO VARIABLES !!!!!!! ##############################
PASSWORD='Password'
USERNAME='Username'
######################################################################

Now replace the Username and Password with your own combination. Make sure they remain
between singe quotes! Then save the file and upload it to the correct folder on your xbox.

--------------------------------------------------------------------------------------------
 4.b Some channels are not working? How come?
--------------------------------------------------------------------------------------------
Very often the problem is not the script but the site that is having the problems! So before
you start posting/writing-e-mails/sending-me-logfiles CHECK THE WEBSITES of the channels 
first. Go to www.uitzendinggemist.nl, www.tien.tv, www.rtl.nl, joox.net and/or 
www.pczapper.tv to see if the websites are up and running. If they are not working, neither
will Uitzendinggemist.v2!
If you have verified that the websites are up and running and the script is still not 
working then start posting/writing-e-mails/sending-me-logfiles, but please, always include
the COMPLETE uzg.log logfile so I can see what the problem is.

--------------------------------------------------------------------------------------------
 5. Acknowledgement
--------------------------------------------------------------------------------------------
Uitzendinggemist v2.0 is a continuation of a script by BaKMaN (http://xbox.readrss.com). 
Basic idea and part of the scripting credits go to him or any other previous developer.