[Arabic] [Bulgarian] [Catalan] [Chinese (simplified)] [Chinese (traditional)] [Croatian] [Czech] [Danish] [Dutch] [Filipino] [Finish] [French] [German] [Greek] [Hebrew] [Hindi] [Indonesian] [Italian] [Japanese] [Korean] [Latvian] [Lithuanian] [Norwegian] [Polish] [Portuguese] [Romanian] [Russian] [Serbian] [Slovak] [Slovenian] [Spanish] [Swedish] [Ukrainian] [Vietnamese]
1. BattClock
1.1 Features
1.2 Which other solutions exist
2. Screenshots
3. Installation
3.1 How to install?
3.2 How to use?
3.3 How to configure?
3.4 Settings for different phones (posted by users)
4. Settings
4.1 Content
4.2 Location
4.3 Fonts
4.4 Display Formats
4.5 Colors
4.6 Log
4.7 Stripes
4.8 Others
4.9 Wifi
4.10 Mobile
4.11 About
4.12 Registry status keys
5. Changelog
6. Downloads
7. Support
8. Wish/TODO list
9. Donations (make sure you are listed too ;-)
4. Settings
It is possible to overrule the default settings via registry HKEY_CURRENT_USER\Software\ZuinigeRijder\BattClock3 or via the separate battconfig program, available in Programs.
Note that with BattConfig you can configure the settings for Portrait and Landscape. For configuring Landscape, make sure your phone is in Landscape orientation and start BattConfig. The Landscape settings are then adapted (and you see the BattClock changing appropriate).
Please use a registry editor to update the registry values, e.g. PHM RegEdit or use the BattConfig program. The advantage of the BattConfig program, is that the changes are immediately reflected in BattClock. A value of 0 means No and a value of 1 means Yes. The default DWORD value is also mentioned. Please make sure to do stop BattClock and start BattClock via Programs or do a soft reset after adding the appropriate overrule settings.
4.1 Content
Maximal 12 BattClock info items can be shown. Just select the info item to show, by pressing the appropriate item to change. Note that the associated BattClock area is shown before the info item as convenience. A new selector window appears, where you can select the info item. Press "Ok" if you want to select a new item or "Cancel" if you want to keep the current selection.
It is also possible to divide the information horizontally, then more than 3 rows will probably be readable, if the width is large enough. Also it is possible to show the last row circular, so e.g. you can display 3 rows, and the third row is circular refreshed with the info of row 3, 4, 5, and 6. You can configure per row which info you want to show. The BattClock rectangle is divided into the number of rows shown and each info is written in that part (centered vertically and horizontally). The number defines what info is shown.
Content Registry Keys
If you cannot use the BattConfig program, you can change the following registry keys.BattClockInfo1 .. BattClockInfo12, the value correspond to the following info:
4.2 Location
You can specify the locations of BattClock Areas 1 till 6. Just press the + and - to switch to the next/previous battClock area. Note that you can enable/disable BattClocak Area 2 till 6, BattClock Area 1 is always enabled.
Enabled (AreaEnabled = 1 decimal)..Area6Enabled
By default only BattClock Area 1 is enabled.X (ClockX = -96 decimal)..Clock6X
X(ClockXLandscape = -96 decimal)..Clock6XLandscape
By default, the ClockX position of the BattClock is positioned over the Windows Mobile battery clock/time. The minus value means relative to the right, so it also adapts itself to landscape mode. In the registry, no minus fields are shown, but it corresponds to unsigned 4294967200 decimal or FFFFFFA0 hexadecimal. If you want to position the BattClock from the left, just specify a positive X position.Y (ClockY = 2)..Clock6Y
Y (ClockYLandscape = 2)..Clock6YLandscape
Specifies the ClockY position of the BattClock, measured from the top of the TaskBar. Because of the stripes, 2 pixels from the top are chosen. The BattClock area is then not overlapped by the stripes. If you do not use stripes, you can change it into 0.W (ClockWidth = 48 decimal or 30 hexadecimal)..Clock6Width
W (ClockWidthLandscape = 48 decimal or 30 hexadecimal)..Clock6WidthLandscape
Specifies the ClockWidth of the BattClock. The default value gives enough room for the Clock and battery life percentage.H (ClockHeight = 46 decimal or 2E hexadecimal)..Clock6Height
H (ClockHeightLandscape = 46 decimal or 2E hexadecimal)..ClockHeight6Landscape
Specifies the ClockWidth of the BattClock. The default value gives enough room for the Clock and battery life percentage. Because of the stripes, 2 pixels from the bottom are chosen. The BattClock area is then not overlapped by the stripes. If you do not use stripes, you can change it into 0.Same Locations for Landscape
Convenience to set all locations for landscape the same as for portrait. Note that BattClock/BattConfig detects portrait or landscape mode. So you can configure the portrait or landscape settings by running the device in portrait or landscape, when BattConfig is started. So you have full control of the portrait and landscape settings individually.Rows (BattClockInfoRows..BattClockInfo6Rows = 2), Columns (BattClockInfoColumns..BattClockInfo6Columns = 1)
You can divide the BattClock area into Rows x Columns. Just set the appropriate values. The total number of items cannot exceed 12. Make sure you make the BattClock area large enough, to show the content properly.BattClock Press Command (BattClockPressCommand1..BattClockPressCommand6)
You can fill in a command to be executed when the associated BattClock area is pressed. Note that when a command is filled in, the underlying info covered by the BattClock area will not receive the Press anymore.4.3 Fonts
(FontSize1..12 = 16), (FontName1..12 = "Tahoma"), (FontType1..12 = 1)
Defines the FontSize, FontName and FontTpe of the BattClock per info item. Dependent of the ClockWidth and ClockHeight and what is shown, a larger fontsize can be better readable. Just make sure the information fits in the BattClock. The content will be divided as ratio of the fontSizes (vertical and horizontal centered).By clicking on the "FontSize, FontName, FontTpe" button, the FontPicker will be opened. You can choose another FontSize, FontName and FontType by clicking the appropriate + and - button.
Same Fontsize for Landscape, (FontSizeLandscape1..12 = 16)
Convenience to set all fontsize for landscape the same as for portrait. Note that BattClock/BattConfig detects portrait or landscape mode. So you can configure the portrait or landscape settings by running the device in portrait or landscape, when BattConfig is started. So you have full control of the portrait and landscape settings individually.4.4 Display Formats
(Format0..81)
Define the display format for a displayed item. Just click the first item to choose the Display Format you want to change. Make sure the information fits in the BattClock. The display formats can be specified, like %d and %s, which will be replaced by a number or a string. And you can prepend or append strings. If you want to show a percentage sign, %, then you need to escape that with an extra %.By default the text will be aligned in the middle (horizontal and vertical). You can align text horizontal (left or right) and/or vertical (top or bottom). Just prefix display format by < (left) or >: (right) ^ (top) v (bottom) [ (left bottom), ] (right bottom) { (left top) } (right top).
So you are in total control what is displayed. The display is only one value, so only one display format needs to be specified. Actually I can just feed the display format to printf like functions, so the same format needs to be used. Examples, see here
Examples:
The side effect that it is a bit more difficult to specify, but novice users can stick to %d and %s
DateTime formats
Of course you will not put this long string in your taskbar, but you can see that you can format to your likings:
Define the DateTime formats according to the wcsftime specification.
%a Abbreviated weekday name %A Full weekday name %b Abbreviated month name %B Full month name %c Date and time representation appropriate for locale %d Day of month as decimal number (01 - 31) %H Hour in 24-hour format (00 - 23) %I Hour in 12-hour format (01 - 12) %j Day of year as decimal number (001 - 366) %m Month as decimal number (01 - 12) %M Minute as decimal number (00 - 59) %p Current locale's A.M./P.M. indicator for 12-hour clock %S Second as decimal number (00 - 59) %U Week of year as decimal number, with Sunday as first day of week (00 - 53) %w Weekday as decimal number (0 - 6; Sunday is 0) %W Week of year as decimal number, with Monday as first day of week (00 - 53) %x Date representation for current locale %X Time representation for current locale %y Year without century, as decimal number (00 - 99) %Y Year with century, as decimal number %z, %Z Either the time-zone name or time zone abbreviation, depending on registry settings; no characters if time zone is unknown %% Percent sign
Any formatting code may be prefixed with the # flag, to have following behaviour:
Format9 = "%S%p" (default seconds and AM/PM)
Format10 = "W%W" (default weeknumber)
Format11 = "%a" (default abbreviated day name)
Multiply ("InfoMultiplier1".."InfoMultiplier81"), Divide By ("InfoDivideBy1".."InfoDivideBy81")
Option to have a multiplier and divider for an Info value, e.g. to convert a value from seconds to hours, convert from Bytes to KB or MB, etc.Registry keys
Define the registry keys to show information for. Note that the registry key must be a DWORD or String value. Press the RegKey button to select the appropriate RegKey to change. Defaults:Here is a list of Windows Mobile Registry keys, which might be applicable for your phone:
Note that when the registry is a string, you must specify %s in the display format.
4.5 Colors
Back color (ClockBackground = 0)
Specifies the ClockBackground color. 0 corresponds to Black, BGR(255,255,255), Blue, Green, Red sequence.G (ClockBackgroundRight = ClockBackGround)
You can specify a Gradient color, by selecting a different color for the lower right part. By default the color is a vertical gradient. If you change the Background color, automatically the Gradient color is reset. So first set the Background color and then set the lower right color to have a gradient color.Back Image
It is possible to have a background image for the BattClock area. The BattClock information is drawn over the background image (so both are drawn). This is great if you do not have a solid taskbar color or if you want to have nice icon look with the info within the icon look. I am sure that people will have some fantastic designs. Best is to first determine the size of the BattClock and than make a background image with that exact size.Back Image (ClockBackImage = "Full path to image")
Back Image (ClockBackImageLandscape = "Full path to image")
Specifies the ClockBackImage path. The image can be of type jpg, png or bmp. First the image is drawn inside the BattClock rectangle and then the info is drawn on top.Same for Landscape
Convenience to set Background image for landscape the same as for portrait. Note that BattClock/BattConfig detects portrait or landscape mode. So you can configure the portrait or landscape settings by running the device in portrait or landscape, when BattConfig is started. So you have full control of the portrait and landscape settings individually.Status colors
Dependent of the associated value exceeding a threshold a different text color can be shown. You can configure thresholds and 3 different colors. Just press +/- to go the BattClock info item where you want to change the status colors for.Low (colorLow0..81 = Text color)
Medium (colorMedium0..81 = Text color)
High (colorHigh0..81 = Text Color)
Low (colorLow0..81Value = 0 decimal)
High (colorMedium0..81Value = -1 decimal)
Define the medium and low threshold values. When the low value is greater than the high value, then only the medium color will be used.Sound
Dependent of the associated value exceeding a threshold (the same threshold as configured in Status Colors above) a different sound can be played. You can configure 3 different sounds, when entering Low, Medium and/or High value. When a sound is configured L/M/H is shown in Orange color. Just press +/- to go the BattClock info item where you want to change the sound for and press L, M and/or H. If you want to remove the sound press Cancel.Low (soundLow0..81 = Sound file location)
Medium (soundMedium0..81 = Sound file location)
High (soundHigh0..81 = Sound file location)
Vibrate
Dependent of the associated value exceeding a threshold (the same threshold as configured in Status Colors above) a different vibrate pattern can be played. You can configure 3 different vibration patterns, when entering Low, Medium and/or High value. When a vibration pattern is configured L/M/H is shown in Orange color. Just press +/- to go the BattClock info item where you want to change the vibration pattern for and press L, M and/or H. The vibration pattern consist of a sequence of numbers, separated by a comma.Default pattern is "75,-75,150,-150,75,-75,75". You can configure 5 times a different duration for vibrate on. If you want to remove the vibrate pattern press Cancel.
Low (vibrateLow0..81 = Vibration pattern)
Medium (vibrateMedium0..81 = Vibration pattern)
High (vibrateHigh0..81 = Vibration pattern)
4.6 Log
Just click the button of the current selected item (or press + or -), to select another item to change the settings for.
You have full control over which numeric info to log to the registry, ("LogToRegistry1" .. "LogToRegistryN"). Note that this is usefull if you want to react with other programs on these registry keys, e.g. Mortscript or HomeScreen++. For the list of Registry Status Keys, see here
You have full control over which numeric info to log to to a comma separated log file BattClock.csv ("LogToFile1" .. "LogToFileN"). Each line in BattClock.csv starts with date/time with seconds resolution (yyymmdd hh:mm:ss) and thereafter the bare info. Only when one of the values to log are changed, they will be logged. On the Other settings screen, you can set the minimum elapsed seconds setting before you log to the log file ("LogToFileSeconds"). So only log file updates will be done when there is a change in one of the log items AND the minimum number of seconds have been elapsed. This can keep the log file smaller. But still the log file can grow huge, so make sure to regularly copy them to another place and start with an empty one (disable BattClock for doing that, otherwise the file may be locked). On you desktop you can open it with Excel or another tool.
Note that the log files will be written in the same directory as were BattClock is installed.
4.7 Stripes
6 BattClock stripes, per BattClock stripe the following can be configured.
The first button (or press + or -) selects the Stripe to configure (Stripe1Info..Stripe6Info).
The next button selects the numeric content to be used for the Stripe.
You can disable a Stripe by selecting Empty for the content.
You have full control over the Stripe position via:
Stripes in Landscape and stripes from right to left. The positions can be negative (measure from the right/bottom): X, X2, Y, Y2.
Vertical stripes when height is bigger than width, (Y2 - Y) > (X2 - X):
Status colors
Dependent of the percentage a different stripe color can be shown. You can configure thresholds and 3 different colors. When Charging and you have configured Battery %, then the stripe will alternate between the configured colors once per second.Back color (Stripe1BackColor..Stripe6BackColor)
You can change the backgound color of the stripe. Default it will be the same as the background of the BattClock area.Low (Stripe1LowColor..Stripe6LowColor), Medium (Stripe1MediumColor..Stripe6MediumColor), High (Stripe1HighColor..Stripe6HighColor)
Define the low, medium and high colors.25 (Stripe1Low..Stripe6Low), 50 (Stripe1Medium..Stripe6Medium)
Define the medium and low threshold percentages for the percentages. Maximum 100, Minimum 0.100 (Stripe1Max..Stripe6Max = 100 decimal)
Define the Maximum value, so also non percentage can be shown.Window Name (Stripe1Window..Stripe6Window)
To subclass other windows than taskbar window, so you can put the BattClock items e.g. on your home screen instead of the taskbar. Note that the Window Name DesktopExplorerWindow is on my Touch Diamond the Home screen (works in Windows Mobile standard Today screen and Touch Flo 3D) Note that BattClock will not work correctly when the Window does not (yet) exist. If it does not yet exist, it will poll each 5 seconds, till the window is there. See here for a list of window names.Solid Line (Stripe1Solid..Stripe6Solid)
Default per 10% a few pixels are not drawn, so you have a good feeling of the percentage left. If you do not want this behaviour, but a solid line, then check this option.Gradient Line (Stripe1Gradient..Stripe6Gradient)
If you want a Gradient line, then check this option. The Gradient will be drawn using Low Color, Medium Color and High Color. Note that you can combine Solid/non-solid in combination with a Gradient Line.Sound
Dependent of the associated value exceeding a threshold (the same threshold as configured in Status Colors above) a different sound can be played. You can configure 3 different sounds, when entering Low, Medium and/or High value. When a sound is configured L/M/H is shown in Orange color. Just press +/- to go the BattClock info item where you want to change the sound for and press L, M and/or H. If you want to remove the sound press Cancel.Low (Stripe1..6LowSound = Sound file location)
Medium (Stripe1..6MediumSound = Sound file location)
High (Stripe1..6HighSound = Sound file location)
Vibrate
Dependent of the associated value exceeding a threshold (the same threshold as configured in Status Colors above) a different vibrate pattern can be played. You can configure 3 different vibration patterns, when entering Low, Medium and/or High value. When a vibration pattern is configured L/M/H is shown in Orange color. Just press +/- to go the BattClock info item where you want to change the vibration pattern for and press L, M and/or H. The vibration pattern consist of a sequence of numbers, separated by a comma.Default pattern is "75,-75,150,-150,75,-75,75". You can configure 5 times a different duration for vibrate on. If you want to remove the vibrate pattern press Cancel.
Low (Stripe1..6LowVibrate = Vibration pattern)
Medium (Stripe1..6MediumVibrate = Vibration pattern)
High (Stripe1..6HighVibrate = Vibration pattern)
4.8 Others
Update speed Seconds
Control the poll speed of the items in seconds. Just press the + or - button, to select the next/previous poll speed and type in the appropriate number of seconds. (default) values how often is checked:Monitor with screen off (MonitorWithScreenOff = 1)
Disable this checkbox to configure BattClock not to monitor with screen off (may safe a little bit battery). Note that this might also have side effects, e.g. updates only done at screen on, e.g. Battery Voltage.Detect Background (DetectBackground = 0)
X (DetectBackgroundX = 0)
Y (DetectBackgroundY = 24)
Option to automatic detect taskbar background color changes and take over the background color of a configurable pixel location. This is great of you have a changing color theme with a solid color. You can configure the pixel location where to take the color from. Make sure it is not overlapped by the BattClock area itself or other information.LogToFile(LogToFileSeconds = 1)
Minimum elapsed seconds setting before you log to the log file. So only log file updates will be done when there is a change in one of the log items AND the minimum number of seconds have been elapsed. This can keep the log file smaller.Window Name (TaskBarWindowName = "")
To subclass other windows than taskbar window, so you can put the BattClock items e.g. on your home screen instead of the taskbar. Note that the Window Name DesktopExplorerWindow is on my Touch Diamond the Home screen (works in Windows Mobile standard Today screen and Touch Flo 3D) Note that BattClock will not work correctly when the Window does not (yet) exist. If it does not yet exist, it will poll each 5 seconds, till the window is there. See here for a list of window names.4.9 Wifi
You can reset the totals for the Wifi for all sessions to 0, by clicking the "Reset" button. Alternatively you can also fill in the values, by putting the numbers inside the appropriate fields (e.g. if you have a data plan):
You can also configure a stripe to show how far you are off the maximum you want.
Make sure to set the "Stripe Max" to the maximum value for e.g. WifiKBytesTotal and set a RegKey to
4.10 Mobile
You can reset the totals for the Mobile data for all sessions to 0, by clicking the "Reset" button. Alternatively you can also fill in the values, by putting the numbers inside the appropriate fields (e.g. if you have a data plan):
You can also configure a stripe to show how far you are off the maximum you want.
Make sure to set the "Stripe Max" to the maximum value for e.g. MobileKBytesTotal and set a RegKey to
4.11 About
The current installed version is shown in the About screen.
LogDebug (LogDebug = 0)
Default there will be no debug logging written. When changing the setting to 1, it will write debug logging in the root of your phone: \\battclock.log.txtThis is handy for reporting problems. Please report the problem description and at which time it occurred and upload the log file. Note that the size of this file can grow big, so normally do not enable this setting or only for a relative short time.
4.12 Registry status keys
The Status of BattClock is written below the registry key HKEY_CURRENT_USER\Software\ZuinigeRijder\Status, so other programs can can react on that, e.g. mortscript actions:
1. BattClock
1.1 Features
1.2 Which other solutions exist
2. Screenshots
3. Installation
3.1 How to install?
3.2 How to use?
3.3 How to configure?
3.4 Settings for different phones (posted by users)
4. Settings
4.1 Content
4.2 Location
4.3 Fonts
4.4 Display Formats
4.5 Colors
4.6 Log
4.7 Stripes
4.8 Others
4.9 Wifi
4.10 Mobile
4.11 About
4.12 Registry status keys
5. Changelog
6. Downloads
7. Support
8. Wish/TODO list
9. Donations (make sure you are listed too ;-)