Rainmeter Samurize utilities

Rainmeter
plugins
& mods

These plugins / mods are 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. The numeric value is the number of unread messages.

Instructions

Create a Plugin measure for each mailserver. Some servers may want a specifc port, security setting etc (you'll find them in your mail program under "Accounts").

[msGmail]
Measure=Plugin
Plugin=EmailChecker
ServerType=GmailAtom
Username=[username]
PasswordFile=[yourpasswordfile]
Plugin measure settings

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

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

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)

From a String measure, call the plugin's GetData(tag, index) function in a section variable. "tag" indicates which info to get (see table below), "index" is the entry number in the list of new messages. Lower numbers usually mean "more recent".

[mGmailSubj]
Meter=String
Text=[&msGmail:GetData("(subject)","0")]
UpdateDivider=#emailDiv#
DynamicVariables=1
GetData() tags

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

Typical settings

Name

Address

Port

Security

POP

Gmail

pop.gmail.com

995

SSL

Outlook

pop-mail.outlook.com

995

SSL

Yahoo

pop.mail.yahoo.com

995

SSL

IMAP

Gmail

imap.gmail.com

993

SSL

Outlook

imap-mail.outlook.com

993

SSL

Protonmail

127.0.0.1

1143

STARTTLS

Download

Makes use of the GemBox library

The non-test skins are designed to drop down / collapse, depending on messages (no messages = nothing visible).

Change log:

1.20.5.10

Initial release

1.20.5.22

Fixed password file checking with delay on

Download EmailChecker_plugin_demo_skins_1.20.5.22.rmskin (959K)