Foreword.
 |
MX610 mouse from Logitech have a remarkable feature: two additional buttons with leds to notify user about unread messages. Alas, SetPoint drivers allow using these lights only with Microsoft Outlook and Windows Messenger. Such imperfections of drivers nullify this feature and many users newer see this buttons lit. The program described below is designed to give an opportunity to use this button with other mail and IM programs. I use The Bat and Lotus Notes as mail programs and QIP for instant messaging, so the program is fully tested with this software only, but I was reported that after small adjustment the program can work with Thunderbird, ICQ, GMail notifier, Live! Messenger, R&Q messenger, Miranda messenger, Trillian and may be some others. The program only lits buttons LEDs; if you want to assign some actions on this buttons try to use uberOptions. |
Install.
Download setup package. Run setup wizard. Follow instructions.
Package contains:
- M610 Lamplighter program
- M610 Lamplighter console utility
- This html file.
Adjustment.
Let's have a closer look at program main widow.
 |
|
The program can monitor system tray for specific string in icons tooltip (2) and monitor specific window (1) for icon changing.
Tooltip is a short message that appear under tray icon when you point mouse on it (14).
To change monitor settings press button (7).
The first section in INI file is [Global]
| WndElapse | Scaning period for animated icon in specific window [ms] |
| TrayElapse | Scaning period for tray tooltips [ms] |
| GhostMode | If set to "1" program go to ghost mode after 60 seconds from starting. |
| FirstTime | Does program runs first time ("1" yes; "0" no) |
| MaxSearchLevel | This parameter mean how deep program will search for specific window in windows tree. |
I don't recommended you to set WndElapse less than 1000 and TrayElapse less than 3000, it can reduse system performance.
High value of MaxSearchLevel also can cause system lag, especially when window can't be found.
[WindowsX] section describes how lamplighter can find window to monitor icon animation.
It seems the only program that always animate icon when unread message present is The Bat, so if you don't use it just remove [WindowsX] section from ini file, else you don't need make any changes there.
Next parameters in [WindowX] and [TrayX] section describes program action when monitored condition met.
| Enabled | Is this section enabled ("1" yes; "0" no) |
| ValueON |
Number of control sequence that will be sent to driver when condition met. |
| ValueOFF |
Number of control sequence that will be sent to driver meeting of condition stopped. |
Numbers of control sequences can be taken from list box (9).
You can add up to 5 ( [Window0] - [Window4] and [Tray0] - [Tray4] ) sections
[TrayX] section.
| Text | No case sensitive part of icon tooltip that program waits for. |
This parts shown in main program window (3) and text where it searched (4) also shown.
So to make lamplighter program workable with program ABC open the lamplighter window, when unread ABC message exists and try to figure out what string you have to wait for. You also can try to change TrayElapse to 1000 for faster update. When string found write it in Text field.
If there is no changing in tool tip strings, try to find out whether ABC changes icon for some window if unread message present. It looks like blink or animated icon in upper left corner of window frame. If there is one put it's parameters in INI file [WindowX] section.
If no such window can be found this means that lamplighter application can't be used to monitor ABC unread messages.
Don't forget to save ini file and restart lamplighter program to apply changing.
Here some examples of [TrayX] section Text field for various programs
| Program | Version | Language | Text field value |
| Gmail Notifier | english | unread conversation | |
| QIP | english | - MESSAGE FROM | |
| Thunderbird | english | new message | |
| Thunderbird | german | NACHRICHT VON | |
| Thunderbird | french | NOUVEAU MESSAGE | |
| Live! Messenger (only works for first message): | english | says: | |
| ICQ | 5.0 | english | Message from |
| ICQ | 5.0 | russian | Сообщение от |
| ICQ | 6.0 | english | sent you something |
| ICQ | 6.0 | russian | послал вам что-то |
| Lotus Notes | english | YOU HAVE NEW MAIL ON |
The way to put two events on one mouse LED.
I’m use two mail programs The Bat and Lotus Notes and I need next behavior for Mail LED
| The Bat | Lotus Notes | LED state | |
| Unread mail presence |
yes |
yes |
turn on |
|
yes |
no |
turn on | |
|
no |
yes |
blink | |
|
no |
no |
turn off |
It is impossible to implement this using ValueON and ValueOFF keys, because of interference between this two events. For example, when Bat mail comes button led turn on, then comes Lotus mail, button start to blink and when I read Lotus mail the button led will be turn off, but it expected to be turn on because of unread Bat mail.
So I hardcode table described above in program and add alternate keys just for this case.
| UseSwitch | Is multi event logic enabled (“1” – yes “0” - no) |
When it set to “1” ValueON and ValueOFF keys ignored.
| Group |
“0” for Mail button and “1” for IM button |
| Switch |
Only two events supported, so use “0” for first event, and “1” for second one. |
Here is the part of my INI file as example.
|
[Window1] [Tray2] |
Download.
Download MX610 Lamplighter setup package.
Current version 2.7.1 released 14/08/07.
MX610LLC console utillity.
Source code available at Google Code.
Uber options - software to enable all options on all buttons in SetPoint drivers.
Detailed instructions to get lamplighter work with Gmail Notifier
Trillian im and email indicator howto.
Discussing MX610 lamplighter:
Logitech forum
Miranda forum
QIP forum (russian)
IXBT forum (russian)
Hardware.FR forum (french)
- There is small console utility included in lamplighter setup package. You can use it to lit mouse LEDs from other programs. Just run this program with number of control squence in parameter.
- Lamplighter program works with USB version of MX610 mouse only.
Contacts.
