Raspberry Pi Home Hub: Building and sending a daily email briefing
The next feature for my Raspberry Pi Home Hub is a Python script that will automatically send an email briefing every morning. In this post I’ll be creating the template, populating it with up-to-date information, and sending it with Yagmail.
How the email briefing will work
The specifications for my Raspberry Pi Home Hub state: “The Home Hub will automatically send a briefing email at around 6:30am every day containing information that would be useful to review each morning.” The way I’m going to implement this can be broken down into four primary steps:
- Create an HTML email briefing template
- Populate the email template with up-to-date information
- Send the email using the Yagmail Python library
- Create a Linux cron job to automatically run the script each day
This post will cover the middle two steps, under the assumption that an HTML template has already been created containing variables looking something like this:
Note that this HTML is messier than the template for the news and weather screen. As this is an email template, all the formatting must be in-line, rather than in a separate CSS stylesheet.
As the news and weather screen is the only one we’ve created to date, we’ll focus on gathering up-to-date news headlines, travel information, and weather updates and packaging them in a nice daily email briefing for the user along with a random greeting and tips for the day.
Setting things up
As with any Home Hub module, the first step is to import some libraries and build some variables.
We saw most of these libraries the last time around – the important addition is Yagmail, which will enable the Python script to connect to a Gmail account I’ve created for the Home Hub and send the briefing to my address. All of these variables are defined in the
config.ini file we created before.
Next we define
tube_feed_url as we did in the last module, using the variables in
config.ini to build out the addresses required to fetch the data.
Adding a greeting
To make waking up in the morning a bit more pleasant, let’s add a random greeting to kick the email off. This will be followed by the date in the format: “Today is Friday 8th March 2019.”
I’ve added all the possible greetings to a Python list called
greetings. The script then counts the number of entries in the list and generates a random number up to that count. The entry at that number is selected and assigned to the
v0 variable ready to populate the email template.
Generating the date is simple enough using the
today.strftime function, but we still have to do a little work to generate the correct suffix (“st”, “nd”, “rd”, or “th”). This is achieved by running an
if loop on the day number, which is generated with
today.strftime('%d') and assigned to
Adding weather information
The process for fetching the news, weather, and Tube status is the same as in the news screen script. For weather, we use
requests to fetch the data from the Met Office.
The data returned is then split in various ways to get today’s temperature and weather type and assign them to the
v3 variables. We’ll need to do a bit more work with these later to convert the weather type number into descriptive text to use in the email template.
Adding transport updates
The current London Underground state is also retrieved using
Unlike the news and weather screen script, the email briefing script returns the description of the current Tube line status, rather than a number. This string is converted to lower case with
string.lower so it’s suitable for use in its location in the email template.
Adding news headlines
The latest news headlines are returned using
feedparser and the BBC News RSS feed URL.
The top story will feature a thumbnail, headline, and short description, while the other stores will just be clickable headlines. The required information is returned by querying
news_data['entries'] and assigned to a series of variables to be used in the briefing template.
Populating the email template
Now we have all the information, it’s time to populate the HTML email template.
First we open the template file, which is stored in the
templates folder in the app’s
html directory. We create a blank variable called
contents to store the completed email template for sending. Data is appended line by line, in the same way the news and weather screen was built.
For most variables it’s just a case of iterating through the lines and switching out the placeholder for the contents of the correct variable. For others, like the type of weather, we need to select the correct replacement string based on the variable’s value with a nested
Once each line as been checked for all variable tags, it is added to the populated HTML file.
Sending the email
Once the email HTML has been fully built, it’s time to send it. To connect via SMTP, Yagmail requires the sender Gmail account’s address and password, which I have fetched from
Next we use
yag.send along with the destination address (also from the configuration file), the email subject line, and the
contents variable, which at this point contains the HTML for the entire email. If everything is configured correctly, we should now receive our briefing when we run the script!
If we check our inbox, we’ll see a nicely formatted email briefing with a random greeting, the latest news headlines, weather (and advice on what to wear out), and travel updates.
Now the Raspberry Pi Home Hub is capable of displaying the latest news, weather, and travel information and sending a daily email briefing. Next month I’ll be building the energy screen, which will fetch information from Google Sheets and calculate my next energy bills. Look out for a blog post about that in the near future, and be sure to visit the project page if you didn’t catch the other posts.