Notify Mi
🔔 Notify Mi simplifies sending yourself text and email notifications from your personal projects by utilizing your gmail account. It is a convenient and cost-effective solution with the goal of providing you an easy
and free
way to send messages in response to events.
Notify Mi is particularly useful when working with IoT devices. It can allow you to receive messages in response to events such as when a sensor value reaches a certain threshold, when a sensor detects something, when a sensor encounters an error, or when a daily or custom timed event occurs. This makes it easy to keep track of what is happening with your IoT device and react to any change or issue that may arise.
With Notify Mi, you can also attach a file
with your text or email message. The maximum file size allowed is 1 MB and you can use any of the 69 supported file types, thus providing you flexibility in the type of attachment you want to include in your messages.
Table of Contents
Purpose:
Sending notifications through your Gmail account is not a novel idea. Notify Mi is designed to be a modular
and reliable
way to send notifications without having to spend time and effort figuring out how to do it each time you want to add this feature to your project. Plus, the implementation process should be straightforward and take only a couple minutes
. This way, you can focus on other aspects of your project and save time.
Getting Started:
- Generate an app password for your gmail account by clicking here.
- place your gmail address and app password in a tuple like so → ("gmail_address", "app_password")
- (optional) step by step guide on how to generate an app password
- Install Notify Mi
pip install notify_mi
Usage:
Import
from notify_mi import notify
Text messsage Only
notify.send_message("Hello World!",
("gmail", "password"),
phone_number = "your_number",
phone_provider= "your_phone_provider")
Text + Email
notify.send_message("Hello World!",
("gmail", "password"),
phone_number = "your_number",
phone_provider= "your_phone_provider",
send_to = "email@gmail.com")
Email Only
notify.send_message("Hello World!",
("gmail", "password"),
send_to = "email@gmail.com")
Other Parameters
notify.send_message(subject = "EMERGENCY",
message = "No sweets detected in fridge!")
notify.send_message(subject = "I found it",
message = "My dream car",
file_attachment = "/path/car.png")
notify.send_message("Hello World!",
threaded = True)
notify.send_message(threaded = True,
file_attachment = "/path/to/file"
phone_number = "your_number",
phone_provider = "your_phone_provider",
send_to = "email@gmail.com",
sender_credentials = ("gmail", "password"),
message = "No sweets detected in fridge!")
List of Phone Providers
"AT&T", "Boost Mobile", "C-Spire", "Cricket Wireless",
"Consumer Cellular", "Google Project Fi", "Metro PCS",
"Mint Mobile", "Page Plus", "Republic Wireless", "Sprint",
"Straight Talk", "T-Mobile", "Ting", "Tracfone",
"U.S. Cellular", "Verizon", "Virgin Mobile", and "Xfinity Mobile"
Special Thanks:
Alfredo Sequeida for writing a detailed article and for making a great video that went step by step on how to send text messages using python. It was very useful for one of my projects so I am adding to what he did so that other people can find it useful.
Alfredo also made a package named etext so check that out!