Universal email checker
This plugin can check new email on several mailserver types: POP, IMAP, Gmail Atom and Protonmail. it can retrieve the subject, sender and the arrival time.
Instructions
In a plugin measure, create a set of parameters for each of your email accounts , with a number at the end identifying the account (0-8).
[msGmail] Measure=Plugin Plugin=EmailCheckerSimple ; --- 1st email account Name0=Gmail ServerType0=GmailAtom Username0=[username] PasswordFile0=[yourpasswordfile] ; --- 2nd email account Name1=Domain ServerType1=POP ...
| Numbered account settings (#: 0-8) | |
ServerType# |
IMAP, POP or GmailAtom |
ServerAddress# |
Your mailserver e.g. pop.aol.com |
PasswordFile# |
Instead of specifying the password openly as Password=, you can point PasswordFile= to a file containing the password, stored in a secure location |
Password# |
Specify the password directy in the skin. Be careful, if you're not the only one with access to the PC |
Active# |
Turn on/off email checking for this server |
Port# |
(Optional) If your server requires a specific port | Security#protocol |
(Optional) NONE, AUTO, SSL, STARTTLS | Authentication# | (Optional) CRAMMD5, DIGESTMD5, LOGIN, NATIVE, PLAIN, APOP |
IgnoreBadCert# |
(Optional) if you're using Proton Bridge for Protonmail, you need to
disable the cert. check.
This is because Proton's security certificate is for a domain, not an IP, as is the case with the Bridge (127.0.0.1) |
General plugin settings |
Delay |
When Rainmeter first starts, wait this long before the first email check. Useful if you need time to unlock your passwords location, etc |
MaxSubjectLength |
Shorten subject line to this many characters |
Ellipsis |
Mark the end of a trimmed subject with these characters |
MaxFromLength |
Shorten any from-related info to this many characters |
PerAccountMaxMessages |
Limit reported new emails to this many per account |
TotalMaxMessages |
Limit total reported new emails to this many |
Separators (0 or 1) |
Separate accounts with a separator |
SeparatorLength |
Separator length |
Substitute# |
Substitute text in the subject. Usage Substitute#="oldtext":"newtext" |
From a String measure, call the plugin's GetData(tag) function in a section variable. "tag" indicates which info to get (see table below). Every reported new email will be formatted according to this pattern.
[mGmailSubj]
Meter=String
Text=[&msGmail:GetData("(subject)")]
UpdateDivider=#emailDiv#
DynamicVariables=1
| GetData() tags | |
(name) |
Account name |
(initial) |
First letter of the account name |
(count) |
New email count |
(subject) |
Subject line |
(fromperson) |
The name of the sender (if provided) |
(fromemail) |
Full email address of the sender |
(fromuser) |
The "username" of the sender's email (before the @ sign) |
(fromhost) |
The "host" part of the sender's email (after the @ sign) |
(from) |
The sender's name, if provided, otherwise the email |
(date) |
The date the email was received | (time) |
The time the email was received (24-hr format) | (time_12_0) | 12-hr format with leading zeros |
(time_12) |
12-hr format without leading zeros |
(time_24_0) |
24-hr format with leading zeros |
(time_24) |
24-hr format without leading zeros |
(datetime) |
Date and time formatted according to your local settings |
Note: POP servers have no concept of "unread" mail. To get only unread mail from a POP server, set your mail program to delete mail on the server upon retrieval.
All times are given in local time.
Sample skins (included)
A simple test skin
A skin showing 2 emails from 2 mailservers: it displays the server initial,
the subject, user (blurred here) and the arrival time. This skin is designed
to drop down / collapse, depending on messages (no messages = nothing visible)
Download
The skins (other than the simple test one) are designed to drop down / collapse, depending on messages (no messages = nothing visible).
Change log:
1.0.0.0 |
Initial release |
1.21.12.28 |
Made multi-threaded, 6 sec timeout on connections |
Download EmailCheckerSimple_plugin_demo_skins_1.21.12.28.rmskin (540K)