Get TouchLockPro at SourceForge.net. Fast, secure and Free Open Source software downloads

[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]

Custom Search


   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.

BattConfig Index

4.1 Content

BattConfig 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.

BattConfig Content Selector BattConfig Content Selector BattConfig Content Selector

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:

  • 0 = CLOCKINFO_EMPTY, do not display
  • 1 = CLOCKINFO_24HH_MM, 24 hour format with leading zeros, e.g. 15:59 or 01:23
  • 2 = CLOCKINFO_24H_MM, 24 hour format without leading zeros, e.g. 15:59 or 1:23
  • 3 = CLOCKINFO_12HH_MM, 12 hour format with leading zeros, e.g. 3:59
  • 4 = CLOCKINFO_12H_MM, 12 hour format without leading zeros, e.g. 03:59
  • 5 = CLOCKINFO_DD_MM, day-month with leading zeros, e.g. 02-06
  • 6 = CLOCKINFO_D_M, day-month without leading zeros, e.g. 2-6
  • 7 = CLOCKINFO_MM_DD, month-day with leading zeros, e.g. 06-02
  • 8 = CLOCKINFO_M_D, month-day without leading zeros, e.g. 6-2
  • 9 = CLOCKINFO_FORMAT_STRING1, Free date/time format string, default seconds and AM/PM indicator
  • 10 = CLOCKINFO_FORMAT_STRING2, Free date/time format string, default weeknumber
  • 11 = CLOCKINFO_FORMAT_STRING3, Free date/time format string, default the abbreviated day name
  • 12 = CLOCKINFO_BATT, battery percentage left, e.g. 72%
  • 13 = CLOCKINFO_BATTERY_TEMPERATURE, Battery Temperature, e.g. 28.0C, updated once per minute.
  • 14 = CLOCKINFO_BATTERY_CURRENT, Battery Current, e.g. 210mV, polled once per second.
  • 15 = CLOCKINFO_BATTERY_CURRENT_FORCE, as Battery Current but non-cached values are asked the Battery Driver. Dependent on the Battery Driver the info can be more up-to-date but can also drain more battery.
  • 16 = CLOCKINFO_BATTERY_VOLTAGE, Battery Voltage in mV
  • 17 = CLOCKINFO_BATTERY_WATT, Battery Wattage in mW
  • 18 = CLOCKINFO_MINUTES_DISPLAY_ON, the number of minutes the display has been on since starting BattClock
  • 19 = CLOCKINFO_MINUTES_STANDBY, the number of minutes the phone has been standby (means still CPU activity possible)
  • 20 = CLOCKINFO_MINUTES_UPTIME, the number of minutes since starting BattClock
  • 21 = CLOCKINFO_MINUTES_CALL, the number of seconds in a Call
  • 22 = CLOCKINFO_FREE_MEMORY, free memory percentage left, e.g. 42%.
  • 23 = CLOCKINFO_FREE_MEMORY_MB, free memory MB left, e.g. 42 MB.
  • 24 = CLOCKINFO_CPU, CPU usage percentage 2%.
  • 25 = CLOCKINFO_CPU_MHZ, CPU Frequency, e.g. 528 Mhz. Supported phones: Leo/Raphael/Diamond/Topaz/Rhodium/Blackstone/Whitestone and phones having QualComm processor MSM7200, MSM7201, MSM75XX, MSM76XX or Snapdragon processor QSD8250, QSD8650.
  • 26 = CLOCKINFO_REGKEY1, Free DWORD or String registry key to monitor, default Phone Strength
  • 27 = CLOCKINFO_REGKEY2, Free DWORD or String registry key to monitor, default Missed Call Count
  • 28 = CLOCKINFO_REGKEY3, Free DWORD or String registry key to monitor, default Unread SMS Count
  • 29 = CLOCKINFO_REGKEY4, Free DWORD or String registry key to monitor, default Unread Mail Count
  • 30 = CLOCKINFO_REGKEY5, Free DWORD or String registry key to monitor, default Uptime Clock
  • 31 = CLOCKINFO_REGKEY6, Free DWORD or String registry key to monitor, default Uptime ClockSession
  • 32 = CLOCKINFO_WIFICONNECTED, WifiConnected, indication if Wifi is connected, yes or no
  • 33 = CLOCKINFO_WIFIKBITSPERSECOND, WifiKBitsPerSecond, current speed in Kbits per second
  • 34 = CLOCKINFO_WIFIKBYTESRECEIVED, WifiKBytesReceived, number of KiloBytes received for the current session
  • 35 = CLOCKINFO_WIFIKBYTESSENT, WifiKBytesSent, number of KiloBytes sent for the current session
  • 36 = CLOCKINFO_WIFIKBYTES, WifiKBytes, number of KiloBytes received and sent for the current session
  • 37 = CLOCKINFO_WIFICONNECTTIME, WifiConnectTime, connect time in seconds for the current session
  • 38 = CLOCKINFO_WIFIKBYTESRECEIVEDTOTAL, WifiKBytesReceivedTotal, number of KiloBytes received for all the monitored sessions
  • 39 = CLOCKINFO_WIFIKBYTESSENTTOTAL, WifiKBytesSentTotal, number of KiloBytes sent for all the monitored sessions
  • 40 = CLOCKINFO_WIFIKBYTESTOTAL, WifiKBytesTotal, number of KiloBytes received and sent for all the monitored sessions
  • 41 = CLOCKINFO_WIFICONNECTTIMETOTAL, WifiConnectTimeTotal, connect time in seconds for all the monitored sessions
  • 42 = CLOCKINFO_MOBILECONNECTED, MobileConnected, indication if Mobile data is connected, yes or no
  • 43 = CLOCKINFO_MOBILEKBITSPERSECOND, MobileKBitsPerSecond, current speed in Kbits per second
  • 44 = CLOCKINFO_MOBILEKBYTESRECEIVED, MobileKBytesReceived, number of KiloBytes received for the current session
  • 45 = CLOCKINFO_MOBILEKBYTESSENT, MobileKBytesSent, number of KiloBytes sent for the current session
  • 46 = CLOCKINFO_MOBILEKBYTES, MobileKBytes, number of KiloBytes received and sent for the current session
  • 47 = CLOCKINFO_MOBILECONNECTTIME, MobileConnectTime, connect time in seconds for the current session
  • 48 = CLOCKINFO_MOBILEKBYTESRECEIVEDTOTAL, MobileKBytesReceivedTotal, number of KiloBytes received for all the monitored sessions
  • 49 = CLOCKINFO_MOBILEKBYTESSENTTOTAL, MobileKBytesSentTotal, number of KiloBytes sent for all the monitored sessions
  • 50 = CLOCKINFO_MOBILEKBYTESTOTAL, MobileKBytesTotal, number of KiloBytes received and sent for all the monitored sessions
  • 51 = CLOCKINFO_MOBILECONNECTTIMETOTAL, MobileConnectTimeTotal, connect time in seconds for all the monitored sessions
  • 52 = CLOCKINFO_WIFIPACKETSSENT, number of Packets sent for the current session
  • 53 = CLOCKINFO_WIFIPACKETSRECEIVED, number of Packets received for the current session
  • 54 = CLOCKINFO_WIFIPACKETS, number of Packets for the current session
  • 55 = CLOCKINFO_WIFIPACKETSSENTTOTAL,number of Packets sent for all the monitored sessions
  • 56 = CLOCKINFO_WIFIPACKETSRECEIVEDTOTAL, number of Packets received for all the monitored sessions
  • 57 = CLOCKINFO_WIFIPACKETSTOTAL, number of Packets for all the monitored sessions
  • 58 = CLOCKINFO_WIFISIGNALSTRENGTH, Wifi Signal Strength in dBm
  • 59 = CLOCKINFO_WIFISIGNALSTRENGTHPERCENTAGE, Wifi Signal Strength in % (-96 dBm = 0%, -30 dBm = 100%)
  • 60 = CLOCKINFO_TOTAL_UPTIME_BATTERY_MINUTES, the number of minutes for all sessions monitored by BattClock on Battery (survives reboot)
  • 61 = CLOCKINFO_TOTAL_UPTIME_CHARGER_MINUTES, the number of minutes for all sessions monitored by BattClock on Charger (survives reboot)
  • 62 = CLOCKINFO_TOTAL_UPTIME_RECHARGE_MINUTES, the number of minutes for all sessions monitored by BattClock, reset at startup/power up (when the Battery% > 97%) or when full charged (switching from charging to battery and Battery% > 97)
  • 63 = CLOCKINFO_REGKEY7, Free DWORD or String registry key to monitor, default unread voice mails
  • 64 = CLOCKINFO_REGKEY8, Free DWORD or String registry key to monitor, default appointment reminders
  • 65 = CLOCKINFO_REGKEY9, Free DWORD or String registry key to monitor, default appointment all day reminders
  • 66 = CLOCKINFO_REGKEY10, Free DWORD or String registry key to monitor, default alarm reminders
  • 67 = CLOCKINFO_REGKEY11, Free DWORD or String registry key to monitor, default Volume
  • 68 = CLOCKINFO_REGKEY12, Free DWORD or String registry key to monitor, default unread sms
  • 69 = CLOCKINFO_FREE_DISKSPACE_MB, Free disk space of phone in MB
  • 70 = CLOCKINFO_FREE_DISKSPACE_FLASH_MB, Free disk space of storage card in MB
  • 71 = CLOCKINFO_PROCESS_COUNT, Process Count
  • 72 = CLOCKINFO_PROCESS_INFO, Destroyed/Created processes names, prepended with resp. - and + sign, all the changes are displayed one per second, till the last change.
  • 73 = CLOCKINFO_MOBILE_COUNTRY_CODE, Mobile Country Code
  • 74 = CLOCKINFO_MOBILE_NETWORK_CODE, Mobile Network Code
  • 75 = CLOCKINFO_LOCATION_AREA_CODE, Location Area Code
  • 76 = CLOCKINFO_CELLID, Cell ID
  • 77 = CLOCKINFO_TOWER_SIGNAL_STRENGTH, Tower Signal Strength
  • 78 = CLOCKINFO_BASE_STATIONID, Base Station ID (not filled on my Touch Diamond)
  • 79 = CLOCKINFO_GPRS_CELLID, GPRS Cell ID (not seen filled on my Touch Diamond)
  • 80 = CLOCKINFO_GPRS_BASE_STATIONID, GPRS Base Station ID (not seen filled on my Touch Diamond)

    4.2 Location

    BattConfig Location and sizes BattConfig Location and sizes

    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

    BattConfig Content Selector BattConfig Content Selector BattConfig Content Selector

    (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:

  • %d (print as a decimal integer)
  • %6d (print as a decimal integer with a width of at least 6 wide)
  • %f (print as a floating point)
  • %4f (print as a floating point with a width of at least 4 wide)
  • %.4f (print as a floating point with a precision of four characters after the decimal point)
  • %3.2f (print as a floating point at least 3 wide and a precision of 2)
  • %x (print as hexadecimal number)
  • %o (print as octal number)
  • %u (print as unsigned value)
  • %31s (print 31 characters. If the string is smaller the empty positions will be filled with whitespace)
  • %.31s (prints the string, but print only 31 characters of the string. If the string is shorter than 31 the whole string is printed)
  • %-31s (prints at least 31 characters. If the string is smaller whitespace is added at the end)
  • %% (print the percentage character, because it has a special meaning you have to put twice %)

    The side effect that it is a bit more difficult to specify, but novice users can stick to %d and %s

    DateTime formats

    Date/Time format example

    Of course you will not put this long string in your taskbar, but you can see that you can format to your likings:

  • e.g. show AM/PM
  • show weeknumber
  • show seconds
  • show year (for those who forget this each day
  • show day of week

    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:

  • %#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y: Remove leading zeros (if any).
  • %#x: Long date representation, appropriate to current locale. For example: "Tuesday, March 14, 1995".
  • %#c: Long date and time representation, appropriate for current locale. For example: "Tuesday, March 14, 1995, 12:41:29".

    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:
  • Reg Key 1 (RegKey1 = "HKLM\System\State\Phone\Signal Strength Raw") signal strenght percentage
  • Reg Key 2 (RegKey2 = "HKCU\System\State\Phone\Missed Call Count") missed call count
  • Reg Key 3 (RegKey3 = "HKCU\System\State\Messages\sms\Unread\Count") unread sms
  • Reg Key 4 (RegKey4 = "HKCU\System\State\Messages\totalemail\Unread\Count") unread mails
  • Reg Key 5 (RegKey5 = "HKLM\System\Uptime\Clock")
  • Reg Key 6 (RegKey6 = "HKLM\System\Uptime\ClockSession")
  • Reg Key 7 (RegKey7 = "HKCU\System\State\Messages\vmail\Total\Unread\Count") unread voice mails
  • Reg Key 8 (RegKey8 = "HKLM\System\State\Reminder\Count\APPT") appointment reminders
  • Reg Key 9 (RegKey9 = "HKLM\System\State\Reminder\Count\APTALLDAY") appointment all day reminders
  • Reg Key 10 (RegKey10 = "HKLM\System\State\Reminder\Count\ALARM") alarm reminders
  • Reg Key 11 (RegKey11 = "HKCU\ControlPanel\Volume\Volume") Volume
  • Reg Key 12 (RegKey12 = "HKCU\System\State\Messages\sms\Unread\Count") unread sms

    Here is a list of Windows Mobile Registry keys, which might be applicable for your phone:

  • SystemState Registry
  • Common Registry Keys
    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.
  • If you want to play a sound and/or vibrate each time the Medium/Low value increases: add 9110000 to the configured value and configure Vibrate and/or Sound below.
  • If you want to play a sound and/or vibrate each time the Medium/Low value decreases: add 1120000 to the configured value and configure Vibrate and/or Sound below.
  • If you want to play a sound and/or vibrate each time the Medium/Low value increases or decreases: add 10230000 to the configured value and configure Vibrate and/or Sound below.

    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.
  • A positive number means the number of milliseconds vibrate on
  • A negative number means the number of milliseconds vibrate off.
  • 0 means ending the vibration sequence.

    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:

  • Stripe1X..Stripe6X
  • Stripe1X2..Stripe6X2
  • Stripe1Y..Stripe6Y
  • Stripe1Y2.Stripe6Y2

    Stripes in Landscape and stripes from right to left. The positions can be negative (measure from the right/bottom): X, X2, Y, Y2.

  • X and/or X2 negative: measure from the right (great for landscape)
  • X2 < X: draw battstripe from right to left, instead of left to right

    Vertical stripes when height is bigger than width, (Y2 - Y) > (X2 - X):

  • Y and/or Y2 negative: measure from the bottom (great for landscape subclassing DesktopExplorerWindow)
  • Y2 < Y: draw battstripe from bottom to top instead of top to bottom Stripe1Gradient = 1 Stripe1Solid = 0

    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.
  • If you want to play a sound and/or vibrate each time the Max/Medium/Low value increases: add 9110000 to the configured value and configure Vibrate and/or Sound below.
  • If you want to play a sound and/or vibrate each time the Max/Medium/Low value decreases: add 1120000 to the configured value and configure Vibrate and/or Sound below.
  • If you want to play a sound and/or vibrate each time the Max/Medium/Low value increases or decreases: add 10230000 to the configured value and configure Vibrate and/or Sound below.

    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.
  • A positive number means the number of milliseconds vibrate on
  • A negative number means the number of milliseconds vibrate off.
  • 0 means ending the vibration sequence.

    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

    BattConfig 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:
  • CircularSeconds = 3
  • LogToFileSeconds = 1
  • BatteryPollSeconds = 120
  • DetectBackgroundSeconds = 2
  • StartUpDelaySeconds = 1 (new)
  • CpuSeconds = 1 (new)
  • CpuSpeedSeconds = 3 (new)
  • FreeMemorySeconds = 1 (new)
  • RegkeyPollSeconds = 3 (new)
  • WifiSeconds = 1 (new)
  • InternetSeconds = 3 (new)
  • FreeDiskspaceSeconds = 60 (new)
  • ProcessInfoSeconds = 10 (new)
  • TowerInfoSeconds = 90 (new)

    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

    BattConfig 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):

  • WifiKBytesReceivedTotal, number of KiloBytes received for all the monitored sessions
  • WifiKBytesSentTotal, number of KiloBytes sent for all the monitored sessions
  • WifiKBytesTotal, number of KiloBytes received and sent for all the monitored sessions
  • WifiConnectTimeTotal, connect time in seconds for all the monitored sessions

    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
    HKCU\Software\ZuinigeRijder\Status\WifiKBytesTotal and choose that RegKey for the stripe value.

    4.10 Mobile

    BattConfig 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):

  • MobileKBytesReceivedTotal, number of KiloBytes received for all the monitored sessions
  • MobileKBytesSentTotal, number of KiloBytes sent for all the monitored sessions
  • MobileKBytesTotal, number of KiloBytes received and sent for all the monitored sessions
  • MobileConnectTimeTotal, connect time in seconds for all the monitored sessions

    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 HKCU\Software\ZuinigeRijder\Status\MobileKBytesTotal and choose that RegKey for the stripe value.

    4.11 About

    BattConfig About

    The current installed version is shown in the About screen.

  • By clicking BattClock you will be redirected to my site.
  • By clicking Donate you will be redirected to PayPal, where you can donate.
  • By clicking Reset the settings will be reset and BattClock will recompute the defaults. BattConfig will exit automatically.
  • By clicking Export the settings will be exported to \BattClock.reg.txt in the root of your phone memory.
  • By clicking Import the settings will be imported from \BattClock.reg.txt in the root of your phone memory, so make sure to copy the appropriate file to this location before importing.

    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.txt
    This 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:
  • CPU
  • CPU_MHZ
  • FreeMemory
  • FreeMemoryMB
  • FreeDiskspaceMB
  • FreeDiskspaceFlashMB
  • Battery
  • BatteryTemp
  • BatteryCurrent
  • BatteryVoltage
  • BatteryMilliWatt
  • MinutesCalling
  • MinutesDisplayOn
  • MinutesStandby
  • MinutesUptime
  • MobileConnected
  • MobileConnectTime
  • MobileConnectTimeTotal
  • MobileKBitsPerSecond
  • MobileKBytes
  • MobileKBytesReceived
  • MobileKBytesReceivedTotal
  • MobileKBytesSent
  • MobileKBytesSentTotal
  • MobileKBytesTotal
  • WifiConnected
  • WifiConnectTime
  • WifiConnectTimeTotal
  • WifiKBitsPerSecond
  • WifiKBytes
  • WifiKBytesReceived
  • WifiKBytesReceivedTotal
  • WifiKBytesSent
  • WifiKBytesSentTotal
  • WifiKBytesTotal
  • WifiPackets
  • WifiPacketsReceived
  • WifiPacketsReceivedTotal
  • WifiPacketsSent
  • WifiPacketsSentTotal
  • WifiPacketsTotal
  • WifiSignalStrength
  • WifiSignalStrengthPercentage
  • TotalUptimeBatteryMinutes
  • TotalUptimeChargingMinutes
  • TotalUptimeRechargeMinutes
  • ProcessCount
  • ProcessInfo
  • MobileCountryCode
  • MobileNetworkCode
  • LocationAreaCode
  • CellId
  • TowerSignalStrength
  • BaseStationId
  • GPRSCellId
  • GPRSBaseStationId

    Donate PayPal > USD / EUR


       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 ;-)

    Donate PayPal > USD / EUR