Rainmeter Samurize utilities forum

Rainmeter
plugins
& mods

Plugins / mods for the Rainmeter desktop widget app

Universal email checker

Skin with subject user time

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
(seconds)

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#
(number at the end 0-8)

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)

Simple test skin
A simple test skin

Skin with subject user time
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

Download EmailCheckerSimple_plugin_demo_skins_1.20.6.11.rmskin (540K)