[WM6.5] [Titanium plugin] JMLToday V5.65 (14th-January-2010)

[JMHL]

This thread is dedicated only to program versions of JMLToday.

--------------------------------------------------------------------------------------
-> HowTo/Skins/Themes-Thread for JMLToday5.5 now <-
-> FAQs 5.5 <-
-> JMLLibrary <-
-> Explanation of new Directory-structure of 5.5 <-
-> Some more images for clocks, weather also in Post 3,4,5 <-
----------------------------------------------------

Post#2 : Configuration/Parameter Informations

Post#3 : Program Informations

v5.65

BE CAREFUL !!!
previous skins may not work with version >= 5.5.
SKINNERs, see post#2 and post#3 !!!

-> Skins for JMLToday V5.6x <-

To Do for a possible new version:
- fix Private.txt event bug (@benno1)
- fix reccurrent-appointment and double-appointment display bugs
- add 'Rdv2' register key to display 2 appointments on 1st Page (@benno1)


Changelog Version 5.65 : (see post#2 and post#3)
JMLPanex v2.30 required
- Fix bug calendar icone (appointment with category)
- Fix bug voicemail count

Page1 : Main Page
- add flightmode on/off
- add 'discoverable' mode for Bluetooth
- add data off
Page2 : Weather
- JMLConnect.mscr deleted
- new JMLMeteo.exe with new connexion managment
- MSN Weather OR ACCUWeather
- new msn and accu folder for pictures (meteo folder deleted !)
Page3 : Today and Tomorrow Appointments
- next,all-days and recurrent appointments FOR 2 days
- show first category as ICON (if .png exist) instead of number calendar pic
- show duration of appointment
Page4 : Unread SMS
- none
New Page5 : Events
- next anniversaries/birthdays (stored in Contacts application).
- show today private event (in private.txt)
Others :
- Add IsNight and IsBatteryCritical20 registry key.
- new JMLPanels.mscr : enable/disable Page3/Page4/Page5
- New 'cal' folder (categories pic AND numbers calender pic for appointments (from @kane159))[/B]
- Skins : some images in folders are optional -> JMLToday uses default image if the image was not found in skin-images folders -> small skin size !
- add JMLLang_tw (from @kane159)
- add JMLLang_pl (from @Yasioo79)
- fix JMLLang_ru (from @benno1)
- Ephemeride 2010 : .hu, .pl, .fr, .de
- different background for each page
- Fix 12 Hour AM/PM bug (@Jelad)


Thousands of downloads and ...only 10 donations !
For work, coffee, encouragements … for next version *Donate*


Changelog Version 5.5 :
- 4 Pages : Clock/Notification, Weather, Appointments, SMS
- New skins management
- Use -> TICS <- for installation (from @MichelDiamond)
- Use -> MichasRefresh <- for Titanium refresh (from @MichelDiamond)
- fix minors bugs
- new program JMLComm.exe to Activate/Desactivate BT/Wifi
- new program JMLSms.exe to store SMS to registers keys
- new program JMLCalendar.exe to store Appointments to registers keys
- new program JMLMenu.exe to manage all context menus (JMLAction.exe deleted)
- #GOTO command supported (same as JMLPanex)
- %JMLTODAY% and %JMLPANEX% variables for path-file supported
- add Phone-status notification : GPRS, EDGE, 3G... OFF
- add Data-connexion and ActiveSync notifications
- "Update" menu item : only update registry keys (no update weather -> no connexion)
- "Weather" menu item : update weather
- JMLPanex preconfigured for all pages during installation


Installation instructions :
- 1 Install MortScript v4.2 -> *Mortscript site*
- 2 Install JMLPanex v2.30 minimum -> *JMLPanex thread*
- 3 Uninstall previous version of JMLToday if necessary
- 4 Install JMLToday -> you will find the JMLToday-Panel on the Top - tap on it and follow the Installation-Instructions



A "Tap on screen" from the plugin Page1 launches contextual menu.
A "Tab on screen" from the plugin Page2 updates Weather informations.
A "Tab on screen" from the plugin Page3 updates Appointments informations (if necessary).
A "Tab on screen" from the plugin Page4 updates SMS informations (if necessary).
A "Tab on screen" from the plugin Page5 updates birthdays/events informations (if necessary).

Developed on HTC Diamond (VGA 480 × 640).
The skins are all supplied VGA at the origin.
I used the program PLG-Converter for skins that are compatible with other resolutions (QVGA, WQVGA ...).



Have Fun!

... and don't forget
For work performed (JMLToday, JMLPanex, JMLStocks, JMLLauncher), time spent, coffee, encouragements … *Donate*

[JMHL]

Configuration/Parameter Informations

---------------------------------------------------------------------------------------------------------
Skin Management
One folder per skin in skins folder.

In your skin_name folder :
- a skin_name.plg
- a skin_name.pnx (optional)
- clock, clockA, sys.... forder for pictures

-> Some image folders are optional. JMLToday uses default image folder, if the skin doesn't use an own folder.
-> Some images in folders are optional. JMLToday uses default image if the image was not found in skin-images folders.

List of skins at installation :

- default
-------- accu
-------- batt
-------- cal
-------- clock
-------- clockA
-------- msn
-------- sys
-------- default.plg
-------- default.pnx

- JMLTodayV5.6
-------- JMLTodayV5.6.plg
-------- JMLTodayV5.6.pnx[/color]
---------------------------------------------------------------------------------------------------------
MultiLanguage
One file JMLLang_xx.ini per Country in lang folder.

1 – Parameters Ex. JMLLang_us.ini :

[us]
; Language name (appear on the select list)
us=English (US)
; 12h/24h format
hour=12
; time Format (HH:mm = 14:00 for french ,  hh:mm = 02:00 for english)
time=hh:mm

; Weather
weatherlang=en-us
weathertemp=F
; LH=low/high HL=high/low
weatherlohi=HL
; metrique/imperial for weather : 'km/h' or 'mph'
weatherwind=mph
; user format for weather
weathertext=%sky%

; Dates
smallDate=ddd, MMM dd
mediumDate=dddd, MMM dd
fullDate=dddd, MMMM dd
userDate=dddd dd MMMM

; alarm
alarmDate=ddd, MMM dd
alarmTime=hh:mm tt
rdvTime=HH:mm

; text for panel 3-4
NOSMS=No Unread SMS
NOCAL=No Appointment

; text of contextual menu
SMS=SMS
EMAIL=E-Mail
TEL=Missing call
VOICEMAIL=VoiceMail
Update=Update
Clock=Clock/Alarms
City=Modify City
Skin=Change Skin
Cancel=Cancel 
Language=Select Language
Connect=Change Log
Config=Configuration
Titanium=Refresh Titanium

Date format :
dd = Day of month as digits
ddd = Day of week as a three-letter abbreviation
dddd = Day of week as its full name
MM = Month as digits
MMM = Month as a three-letter abbreviation
MMMM = Month as its full name

Time format :
HH = 24 hour clock
hh = 12 hour clock
mm = minutes
t = time marker : A or P
tt = time marker : AM or PM
---------------------------------------------------------------------------------------------------------
Saint/Birthday/Private evenment...
1 – Ephemeris (Saint) : One Ephemeris file per year and per country :
French in 2010 : Ephemeride2010.fr
German in 2010 : Ephemeride2010.de

2 – File format : one line per day (dd/MM<tabulation>text)

3 – Private file
With Private.txt file , you can displayed birthday, …..(same format as ephemeris)

-> If a private evenment exist, it replace the Saint.
---------------------------------------------------------------------------------------------------------
Constantes File-Path
You can use these constantes in your file-path name :

%PROGRAMFILES%
%WINDOWS%
%MYVIDEO%
%MYPICTURES%
%MYMUSIC%
%JMLTODAY%
%JMLPANEX%
---------------------------------------------------------------------------------------------------------
Program/parameters separator
You can use | or ; in your file-path name :

Example :
...=%WINDOWS%\ctlpnl.exe|cplmain.cpl,3
or
...=%WINDOWS%\ctlpnl.exe;cplmain.cpl,3
---------------------------------------------------------------------------------------------------------
Menu/Program association
In the JMLAction.mnu file, use same key in [Menu] section and [Program] section :

[Menu]
Clock=Horloge/Alarmes

[Program]
Clock=%PROGRAMFILES%\ageye\G-Alarm\GAlarm.exe

– Format : key = program;parameters

– Default values :

SMS		= 	%WINDOWS%\\tmail.exe|-service "SMS"
TEL  	=	CallHistory.exe
EMAIL		= 	%WINDOWS%\\tmail.exe|-service "ActiveSync"
VOICEMAIL		= 	%WINDOWS%\\voicemail.exe

Update	=	JMLUpdate.mscr
Weather	=	JMLMeteo.mscr
Clock		=	%WINDOWS%\\ctlpnl.exe|cplmain.cpl,16,0
Skin		=	JMLTodaySkins.mscr
City		=	JMLTodayVille.mscr
Language	=	JMLLang.mscr
Titanium	=	CHomeRefresh.exe

---------------------------------------------------------------------------------------------------------
MSN Weather : List of cities.
Use the file CitiesMSN.txt (Format : codeMSN,cityName)

 
FRXX0016,Bordeaux
FRXX0076,Paris
GMXX0007,Berlin
UKXX0085,London
USNY0996,New York
SPXX0050,Madrid
ITXX0067,Roma
RSXX0063,Moscow
TUXX0002,Ankara
NLXX0002,Amsterdam
HUXX0002,Budapest

---------------------------------------------------------------------------------------------------------
ACCU Weather : List of cities.
Use the file CitiesACCU.txt (Format : codeACCU,cityName)

 
EUR|FR|FR002|BORDEAUX,Bordeaux
EUR|FR|FR012|PARIS,Paris
EUR|DE|GM003|BERLIN,Berlin
EUR|UK|UK241|LONDON,London
EUR|ES|SP013|Madrid,Madrid
EUR|IT|IT007|ROMA,Roma
ASI|RU|RS052|MOSCOW,Moscow
MEA|TR|TU007|ANKARA,Ankara
EUR|NL|NL008|AMSTERDAM,Amsterdam
EUR|HU|HU006|BUDAPEST,Budapest

---------------------------------------------------------------------------------------------------------
Second Clock
Parameters to be added in JMLToday.ini :

 [Offset] 
; Offset in 24H format (with minutes)
Offset =-6:00
;City Name
City = New York

---------------------------------------------------------------------------------------------------------
System Notification
After each system notification, JMLToday can call a personnal script.
-> Add a line parameter in [Notify] section in JMLToday.ini

[Notify]
JMLTodayTime=%PROGRAMFILES%\JMLToday\MyScript.mscr

List of system notification you can intercept :
JMLTodayTel
JMLTodaySms
JMLTodayEmail
JMLTodayVoicemail
JMLTodayBatt
JMLTodayAlarm
JMLTodayTime
JMLTodayDate
JMLTodayCal
JMLTodayOperator
JMLTodayWifi
JMLTodayBlueTooth
JMLTodayActiveSync
JMLTodayData
JMLTodayCellular
---------------------------------------------------------------------------------------------------------
Program Scheduler
You can launch a program at a predefined time:
-> Add a line parameter in [Sceduler] section in JMLToday.ini

[Scheduler]
22:00=%WINDOWS%\ctlpnl.exe|cplmain.cpl,3
00:05=%PROGRAMFILES%\JMLToday\JMLMeteo.mscr

---------------------------------------------------------------------------------------------------------
User format for weather
Register keys 'Text0, TextA, Text1... ' formatted according to weathertext in JMLToday.ini.

Format example : weathertext=%sky% (-> default value)

%jour% = day
%temp% = temperature (according to low/high, high/low defined in .ini)
%sky% = description weather
%LF% = line feed
---------------------------------------------------------------------------------------------------------
Auto-Update Weather
Parameters in [RunAt] section in JMLToday.ini :
- enable : 0=disabled, 1=enabled
- time : start time
- pgm : program launched for updating

Optional Parameters :
- every : number of minutes between 2 updates
- endTime : end time

[RunAt]
enable=1
time=00:35
every=120
endTime=16:00
pgm=JMLMeteo.mscr

---------------------------------------------------------------------------------------------------------
Clock animation
Parameters in [Animation] section in JMLToday.ini :
- sleep : milli-seconds between 2 pictures
- nb : number of pictures for animation
- image : base picture

Example 1 : Nothing or 0
[Animation]
sleep=0

-> NO animation


Example 2 :
[Animation]
sleep=120

-> JMLToday internal animation (minutes animation)

Example 3 :
[Animation]
sleep=120
nb=5
image=bg

-> RIC69 animation : This animation contains 5 pictures ( bg1.png, .... bg5.png)
---------------------------------------------------------------------------------------------------------
SMS/TEL/MAIL/VMAIL central notification
With register keys Total, TotalPuce... you can use only ONE picture.

If you clic on (with JMLPanex >= 1.00) :
If only one type of notification -> launch the appropriate program
If some type of notification -> a contextual menu appear.
---------------------------------------------------------------------------------------------------------

[JMHL]

Program Informations

S2U2 support
JMLToday update this registry key : HKCU\Software\A_C\S2U2\UserWeather
with : "C|icon-weather|T°/T° description-weather"
---------------------------------------------------------------------------------------------------------
Operations of 'Update'
The 'Update' context menu launch the script JMLUpdate.mscr which :
1 - execute JMLToday.exe, "-update" -> Update all values of registry sub-keys of Page1, Page2…… (except weather)
2 - call JMLUpdate.mscr script in your skin_name folder if it's exist (-> you can add/modify registry keys for personnal use)
---------------------------------------------------------------------------------------------------------
Operations of 'Select Language'
The 'Select Language' context menu launch the script JMLLang.mscr which :
1 - update JMLToday.ini file -> with all formats parameter
2 - create JMLAction.mnu file -> with all text of context menu
3 - create JMLTotal.mnu file -> with all text of Notifications Central menu
4 - execute JMLToday.exe, "-update" -> Update all values of registry sub-keys of Page1, Page2…… (except weather)
5 - refresh titanium -> Update values displayed

-> Launch manually the 'update weather' to get description weather in your language.
---------------------------------------------------------------------------------------------------------
Operations of 'Manual Update Weather'
The 'Manual Update Weather' launch the script JMLMeteo.mscr which :
1 - update weather values
2 - call JMLMeteo.mscr script in your skin_name folder if it's exist (-> you can add/modify registry keys for personnal use)
---------------------------------------------------------------------------------------------------------
Operations of 'Skin Change'
The 'Skin Change' context menu launch the script JMLTodaySkins.mscr which :
1 - copy skin_name.pnx file in JMLToday folder
2 - update register keys for clock, batt.... folder
3 - apply skin_name.plg
4 - call JMLSkin.mscr script in your skin_name folder if it's exist (-> you can add/modify registry keys for personnal use)
---------------------------------------------------------------------------------------------------------
Registry Keys
[HKEY_LOCAL_MACHINE\Software\Microsoft\CHome\JMLTod ay] Plugin

SkinName		Name of actual skin	
Version		Version number of plugin		
Connexion		Data connection 			
JMLPanexPage       Actual page number (setting by JMLPanex when you clic on Plugin)
Lang		Language selected		
SkinChanged	JMLTodaySkins.mscr set this key to 1 when skin is changed
SkinError		Name of skin you can't install (error skin resolution in JMLTodaySkins.mscr)	
Ville		City-code for weather 		
meteo		Name of meteo folder 
batt		Name of batt folder 
sys		Name of sys folder 
clock		Name of clock folder 
clockA		Name of clockA folder 
clockO 		Name of clockO folder 
clockAO		Name of clockAO folder 
Height, Width	PocketPC resolution (ex.: 480x640)
RunAt		Next automatic update

[HKEY_LOCAL_MACHINE\Software\Microsoft\CHome\JMLTod ay\Page1] 1st Page

ACTIONURLPNX    value of ACTIONURL before setting JMLPanex (used by JMLResetPlugin.mscr)

PagesPNG	Tele-Command picture
HeaderText	Text personnalizable
Today	 Date

Bkg		Page background	
BG		Digital background		
H1		Digital Hour 	
H2		Digital Hour 
M1		Digital Minutes 
M2		Digital Minutes 	
BGA		Analogic background	
HA		Analogic Hour  	
MA		Analogic Minutes	
BGC		Digital-Compact background

AMPM		Time AM/PM picture 
AMPMO		Offset-time AM/PM picture 

City		Time City
CityO		Offset-time City

Time		Time
TimeO		Offset-time

BGO		Digital Offset-time background
H1O		Digital Offset-time Hour 	
H2O		Digital Offset-time Hour 
M1O		Digital Offset-time Minutes 
M2O		Digital Offset-time Minutes 	

BGAO		Analogic Offset-time background
HAO		Analogic Offset-time Hour  	
MAO		Analogic Offset-time Minutes	

BGCO		Digital-Compact Offset-time background

CellularPNG	Cellular picture (3G, GPRS....)
DataPNG	Data connexion picture (3G, GPRS....)
ActiveSyncPNG	ActiveSync picture (3G, GPRS....)
BattPNG		Battery picture			
BattVAL		Battery percentage	
WiFiPNG		Wifi picture		
BlueToothPNG	Bluetooth picture	
OperatorName	Operator name

Alarm		Date-Time of next alarm	
AlarmPNG	Alarm picture	
Sms		SMS number	
SmsPuce		SMS bubble picture	
SmsPNG		SMS picture		
Tel		TEL number of missing call	
TelPuce		TEL bubble picture	
TelPNG		TEL picture	
Email		EMAIL number	
EmailPuce	EMAIL bubble picture	
EmailPNG	EMAIL picture		
Voicemail	VOICEMAIL number	
VoicemailPuce	VOICEMAIL bubble picture	
VoicemailPNG	VOICEMAIL picture	
Total		Total number = sms+tel+email+voicemail	
TotalPuce		Total bubble picture	
TotalPNG		Total picture	

Rdv		Next appointement	
DateSaint	Date of saint 	
Saint		Name of saint OR private evenment		

CalPNG		Calendar picture
Date		Date with compact month
Date0		Date with compact day & month		
Date1		Full Date		
DateUser		User-Date according to 'userDate" in JMLToday.ini
	
Text0		Today description weather according to 'weathertext" in JMLToday.ini		
Temp0		Today temperature weather		
Icon0		Today weather picture	
Sky0 		Today  sky description	
Maj		Updated weather timestamp
Current		Current weather	(temperature, wind)	
Text		Current description weather		
Icon		Current weather picture

[HKEY_LOCAL_MACHINE\Software\Microsoft\CHome\JMLTod ay\Page2] Weather Page

PagesPNG	Tele-Command picture
HeaderText	Text personnalizable
Today	 Date

Bkg		Page background	

Label4		Text label personnalizable
Jour4		Day 4	
Text4		Day 4 description weather according to 'weathertext" in JMLToday.ini	
Temp4		Day 4 temperature weather
Icon4		Day 4 weather picture
Sky4		Day 4 sky description 	
Label3		Text label personnalizable
Jour3		Day 3
Text3		Day 3 description weather according to 'weathertext" in JMLToday.ini
Temp3		Day 3 temperature weather
Icon3		Day 3 weather picture
Sky3		Day 3 sky description 	
Label2		Text label personnalizable
Jour2		Day 2
Text2		Day 2 description weather according to 'weathertext" in JMLToday.ini
Temp2		Day 2 temperature weather
Icon2		Day 2 weather picture
Sky2		Day 2 sky description 	
Label1		Text label personnalizable
Jour1		Day 1:Tomorrow	
Text1		Day 1:Tomorrow description weather according to 'weathertext" in JMLToday.ini
Temp1		Day 1:Tomorrow temperature weather		
Icon1		Day 1:Tomorrow weather picture	
Sky1		Day 1:Tomorrow sky description 	
LabelA		Text label personnalizable
JourA		Today			
TextA		Today description weather according to 'weathertext" in JMLToday.ini			
TempA		Today temperature weather		
IconA		Today weather picture				
SkyA		Today sky description 	

City2		Name of City 	
Date2		Full date		
DateUser2		User-Date according to 'userDate" in JMLToday.ini

[HKEY_LOCAL_MACHINE\Software\Microsoft\CHome\JMLTod ay\Page3] Appointments Page

PagesPNG	Tele-Command picture
HeaderText	Text personnalizable
Today	 Date
Bkg		Page background	
Label4		Text 
Icon4		picture
Label3		Text 
Icon3		picture
Label2		Text 
Icon2		picture
Label1		Text 
Icon1		picture	
LabelA		Text 
IconA		picture

[HKEY_LOCAL_MACHINE\Software\Microsoft\CHome\JMLTod ay\Page4] Unread SMS Page

PagesPNG	Tele-Command picture
HeaderText	Text personnalizable
Today	 Date
Bkg		Page background	
Label4		Text 
Icon4		picture
Label3		Text 
Icon3		picture
Label2		Text 
Icon2		picture
Label1		Text 
Icon1		picture	
LabelA		Text 
IconA		picture

[HKEY_LOCAL_MACHINE\Software\Microsoft\CHome\JMLTod ay\CondensedPage] Condensed Page

CellularPNG	Cellular picture (3G, GPRS....)
DataPNG	Data connexion picture 
ActiveSyncPNG	ActiveSync picture 
BG	Clock background
BGA	Analogic clock background
BGC	Compact clock background
HA	Analogic hour
MA	Analogic minute

Time		Time		
BattPNG		Battery picture			
WiFiPNG		Wifi picture		
BlueToothPNG	Bluetooth picture	
OperatorName	Operator name
			
Date		Date with compact month
Date0		Date with compact day & month		
Date1		Full Date		
DateUser	User-Date according to 'userDate" in JMLToday.ini
		
Sms		SMS number	
SmsPuce		SMS bubble picture	
Tel		TEL number of missing call	
TelPuce		TEL bubble picture	
Email		EMAIL number	
EmailPuce	EMAIL bubble picture	
Voicemail	VOICEMAIL number	
VoicemailPuce	VOICEMAIL bubble picture	
Total		Total number = sms+tel+email+voicemail	
TotalPuce	Total bubble picture	
	
PluginLabel	Plugin name		
AMPM		AM/PM picture

---------------------------------------------------------------------------------------------------------

[justwonder]

WTF
What if everyone does this.

[norkoastal]

Love the stocks app.... Cant wait to see what this is!!!

[MichelDiamond]

Perhaps JMHL is fallen asleep - it's late night in Europe

(and I needed a little time to translate the initial text for here, sorry JMHL)

I think I'll make here some FAQs, which will come, when 5.2. is provided.

Greetz
Micha

[JMHL]

See #post1

[MrDSL]

Ok this works on my QVGA device and I like it a lot!!

I really wish it was much bigger..I can barely read the weather info..
It would also be nice if it had email notification also so I can get rid of that panel.

I would like to just have this as my only panel since it displays just about everything so hopefully someone whos has some skill can make this panel appear much bigger so its easier to read..


Sweet panel you have done a really good job!! thank you for sharing

[Jumba]

This is very nice but I share the same concerns as the poster above. I'll probably end up resizing the text myself but there's another issue that made me have to reinstall. Dunno if it's because I'm on WQVGA but when I tried to change the theme to the analog clock it says "End of install skin" and the panel just shut down for good. :shrug: Will try and reproduce the error. Otherwise, great panel!

Edit: Tried again, same error. CHome Editor shows the panel as enabled but it's not showing and there seems to be no way of re-enabling it except for a re-install.

Ah okay, I see now the .plg is for vga. No sweat, I'll wait for someone to convert it.

[MrDSL]

Originally Posted by Jumba This is very nice but I share the same concerns as the poster above. I'll probably end up resizing the text myself but there's another issue that made me have to reinstall. Dunno if it's because I'm on WQVGA but when I tried to change the theme to the analog clock it says "End of install skin" and the panel just shut down for good. :shrug: Will try and reproduce the error. Otherwise, great panel! Edit: Tried again, same error. CHome Editor shows the panel as enabled but it's not showing and there seems to be no way of re-enabling it except for a re-install. Ah okay, I see now the .plg is for vga. No sweat, I'll wait for someone to convert it.

Same problem..Loading any skin besides the main one makes the panel dissapear.