---------------------------------------------------------------------------------------------------
WebTV, for Windows Mobile
Developped by JPhReynaud
Tested on HTC Touch Pro HD (WVGA), Windows Mobile 6.1
Run on QVGA, VGA, WVGA and 320x320 screens
Shoud run fine on any Windows Mobile 5/6 machine (Not yet for 240x240 ...)
for any comment or suggestion, thanks to use the Forum :
http://forum.xda-developers.com/showthread.php?t=491288 

---------------------------------------------------------------------------------------------------
Function:
This small piece of software allow to visualise TV strams within a Player 
(Windows Media Player, CorePlayer, TCPMP ...)
Be aware of the costs if you use your GPRS or 3G connexion !
If you run it using you Wireless internet, it will be free.
The software is delivered with an amazing quantity of TV Channels and Shows ...
If you have extra interesting TV streaming link, thanks to share on the forum
I'll add them in the standard configuration in order to share with everybody.


NEW IN VERSION 3.0
From each Tab, you can define the List View mode. 3 Type are allowed 
(Large Icons, Small Icons or Details)

Setup Tab, some functions added.
- You can rename you 5 tabs names. Select desired Tab with the Tab Name Combo and type it's name next to it.
- You can choose to get a DateTime picker in Tab1 (only ...). This is very usefull if you want to (re)visualize
  an old Show (Usually News or Weather). As long as the provider store it you can see it !
  You can (re)visualize for exemple TF1 13h information show from January 1st 2007 !!
- Completely rebuilt Channel Editor 
  By pressing "Channels ..." button, you enter in the new Channel Editor dialog.
  From the File Combo, select any of the proposed channel country packn you will get the channel list in the 
  top Listview. If you want to preview a channel, select it and press the "Play" button
  By selecting a Tab from the middle Combo, you will visualize the currently defined channels for this Tab
  If you want to add or remove or move some Channel from a Tab, you must press "Edit" button to enter in Edition mode.
  nothing can be changed until you press this "Edit" button. 
  When you are in Edit mode, you can add Channel to the selected tab by double clicking on it  or pressing "Add" button
  Also, you can move "Up", move "Down", remove("Del") a channel by pressing appropriate buttons.
  You can empty a tab by pressing "Clear" button. 
  
  Please play with the editor, you'll understand by yourself how to use it, it is simple.

New CountryPack channel files SPECIAL NOTE :
Channel streams are classified per country in xml files. THere is more than 500 channels !
All links as been tested on a PC by a software (connection OK, buffering OK, reading OK). 
If they do not work, this can be few reasons : 
- Not compatible with the Pocket PC players
- Stream is temporaryl OFF for whatever reasons
- Stream as been closed ...

If you want to share some new channels, you have to respect some rules to make this job easier.
As you can imagine, it as been a hard effort to organise and test all those channels ... 
There is today more than 500 channels available, a bit of organization is necessary ...
To add new channels or make correction on existing ones (name, type ... add an icon), 
please edit the appropriate "WebTVList country .xml file and post it on the XDA forum.
For the icons, (many icons are missing) you can create 64x64 jpg files for your favorite 
channels. You can then post them in a Zip file also in the Forum.
I built a small tool that manage importing the updates and check new links automatically.
Every new release will contains the fruitlful results of your modified and added Channels
This way everybody will stay updated. Thanks

Please do not edit WebTVList.xml. This file is automatically generated from your selection
of channels. If you add a channel in this file, it won't be added in the Country pack file.

NEW IN VERSION 3.01 (Favorites Memorization)
Because the Favorites Channels file "WebTVList.xml" was a part of the installation kit, this file was replaced by the 
default one on every reinstallation of the sofware. Users had to make a backup of this file and restore it to keep their
favorites in place. This was not really nice ...
Since version 3.01, this "WebTVList.xml" is not a part of the installation kit anymore. The results is this file will not
be deleted while desinstalling the software for an update. 
But the results is for a first installation of this sofware (never installed any vezrsion of it before) the sofware will 
not have any default channels and all Tabs will be empty .... 
For that reason,  I've added in the installation kit a new 
file named "WebTVList(Example).xml". If the sofware do not find
a WevTVList.xml, it will use the example one instead.
For people updating from a previous version to 3.01, you have to backup you WebTVList.xml (for the last time) before
installing this new version (if you want to keep your favorites ...)

---------------------------------------------------------------------------------------------------
Disclaimer:
This software is the property of it's author.
It can't be sold neither distributed without my prior written acceptation.
The author, of this software accepts no responsibility for damages resulting from the use of this 
product and makes no warranty or representation, either express or implied, including but not 
limited to, any implied warranty of merchantability or fitness for a particular purpose. 
This software is provided "AS IS", and you, its user, assume all risks when using it. 
---------------------------------------------------------------------------------------------------
Instalation:
In the WebTV.zip file, you'll find
"ReadMe.txt"		This text file !
"WebTV Setup.cab"	To copy then run from your pocket PC
			you can install it in the Main memory or in the SD Card
---------------------------------------------------------------------------------------------------
Usage:
Just double click on an Icon to run the stream in the selected Player.
Configuration, see below
---------------------------------------------------------------------------------------------------
Player Setup:
The "Setup" tab allow to select the Player.
By default, WindowsMediaPlayer is selected. To select another player : 
Select any autodetected layer from the Player Combo box
Example :
TCPMP:			Program Files\TCPMP\TCPMP.exe 	
CorePlayer		Program Files\CorePlayer\Player.exe
WindowsMediaPlayer	\Windows\WMPlayer.exe (Warning : WMP doesn't support all stream formats ...)
---------------------------------------------------------------------------------------------------
Channels Files:

They are stored in an  "WebTVList COUNTRY " file :

channels are defined as follow :

<Channel
	Country="France"
	Type="TV France"
	Tab="4"
	Name="TF1"
	Link="mms://a889.l4162624888.c41626.e.lm.akamaistream.net/D/889/41626/v0001/reflector:24888"
	Icon="tf1.jpg"
/>

Channel	Channel id Code (can't be changed)
Country	Native Country of the Channel
Type	Channel Type (Info, TV, Movie ... Country ...)
Tab	Tab Number where you want to see this channel
Name	Channel Name
Link	Stram Address
Icon	Channel Icon (Stored in software sub folder : "\Channel Icons"
	Format jpg, 64x64 pixels.

You can also define some dynamics links/strams (example containing a date)

<Channel
	Country="France"
	Type="Info France"
	Tab="1"
	Name="Journal 20h"
	Link="mms://vodstream.tf1.fr/tf1jt/jt20d*ddMMyyyy*.asf"
	Icon="tf1.jpg"
	RunningDays="LMMJVSD"
	Time="20:00"
	Availability="00:45"
/>
  
Link		Stream address with date Parsing:
		As example, to obtain the 1am News at February 9th 2009, address :
		mms://vodstream.tf1.fr/tf1jt/jt13d09022009.asf
		You have to define the Link as follow:
		mms://vodstream.tf1.fr/tf1jt/jt13d*ddMMyyyy*.asf
		The software can parse the following codes:
		dd : day of Month
		MM : Month
		yy : Year on two Digits
		yyyy : Year on four Digits					
RunningDays	"MTWTFS" or "LMMJVSD"
		The week days  this show is available
		As example, 8am News on Frecnh TF1 channl is not available on Sundays 
		We will the code : "MTWTF-" or "LMMJVS-"
		The days the Show is NOT running are indicated with an "-"
		The days the Show IS running are indicated with any other characters
		This string must be 7 characters length
Time		The time this show is supposed to start, coded "hh:mm. "
		Two digits for Hours then ":" then two digits for Minutes
		This string must be 5 characters length
Availability	Indicates after how long after begining of the show, this one is available on the web
		Usually, (in France) this time is about 45mn  "00:45" to 1 Hour "01:00"
		Coded "hh:mm". 
		Two digits for Hours then ":" then two digits for Minutes
		This string must be 5 characters length
				
---------------------------------------------------------------------------------------------------
Registry		
WebTV is using registry to store some settings

HKEY_CURRENT_USER\Software\WebTV\Language		Language (1:English 2:Franais)
HKEY_CURRENT_USER\Software\WebTV\PlayerName		Selected Player Name
HKEY_CURRENT_USER\Software\WebTV\DatePickerTab1		Date Picker on Tab 1 (True / False)
HKEY_CURRENT_USER\Software\WebTV\ListView		ViewMode1, ViewMode2 ... ViewMode5 (List view type)

---------------------------------------------------------------------------------------------------
Version History:
V1.00	09/02/2009	* Initial Release (French only).

V1.01	13/02/2009	* Auto detection of Players installed on the Mobile among the standards :
			  WindowsMediaPlayer, CorePlayer and TCMPM.
			* Possibility to add other Players names in the detection list (WebTVSetting.xml)
			* Selected Player Name is stored in Registry (instead of Player Path)
			* Auto Refresh on Show dates, according current time for dynamics links
			* This dates indicates "Today", "Yesterady" or "dd/MM/yy" of older
			* Langage selection (English / Franais)
			* Added : ReadMe.txt (This file!)
			* Added : Few Extra Channels
V1.02	13/02/2009	* SD Card Players detection correction1

V1.03	14/02/2009	* SD Card Players detection correction2

V2.00	06/03/2009	* Memory optimization in Channel Icons
			* Added Compatibility with differents screens size (QVGA, VGA, WVGA ...)
			* Few change in WebTVList.xml structure (see above)
			* New tool for Channel reorganisation in Tabs (See usage above)
			* Add French FAI channels Neuf, Free and Alice
			  Sound is not recognized by CorePlayer (codec issue) for Free FAI
			* 96 Channels Total
			
V2.01	08/03/2009	* Added Button "Edit" to enter/quit Channels edition mode

V3.00	14/03/2009	* Added a date time picker in Tab1 to visualize some old Shows (See usage above)
			* Allow List view mode (Large/Small icons or Details)
			* Completely renewed Dialog for Tab Channels configuration
			* Added TV streams organized in CountryPack files. More than 500 Channels ! 

V3.01	15/03/2009	* Removed iExplorer from the Player list (was there only for test purposes and now useless)
			* Sometimes, when pressing Exit menu in Config. Dialog, "Save Modif" question was not displayed.
			* Some cosmetics change to allow running on 320x320 pixels screen. (To confirm from users ...)
			* Favorites channels file "WebTVList.xml" is not part of install kit anymore. 
			  The favorites will be preserved after software reinstallation or update (See more info above)
			* Added Few channels and Channels Icons ...(thanks to xda community)

---------------------------------------------------------------------------------------------------
End of Document
---------------------------------------------------------------------------------------------------

