To Make a THE you require:

1. A Raspberry Pi (a Pi zero, or a Pi 3 ) – we used a Pi 3 for ours.
2. An InkywHAT screen;
3. If using a Pi 3 – a right angled USB cable (so the cable fits in the case);
4. An MQTT broker – either running on your Pi or elsewhere. Don’t worry if you do not have one or are not sure what MQTT is, its quick and easy to set up and once installed it will automatically run – take a look at https://randomnerdtutorials.com/how-to-install-mosquitto-broker-on-raspberry-pi/ for a full and easy to follow tutorial on getting MQTT running – in this case mosquitto on your Pi.
5. An easy to fit case – head over to Thingiverse to download and print our open source case.
6. Our free and open source scripts to collect the Time, News and Environment conditions.

Step One: Installing the InkywHAT
The first step is to set and install your InkyWhat eInk sceen. You can install the libraires required for your InkyWHAT by using the easy one-line-installer.
Open a new terminal to connect to your Pi, and type the following, making sure to type y or n when prompted:

Step Two: Getting the Time, News and Environmental Information
THE updates its information via subscribing to an MQTT topic, our custom scripts pull in other sources of information and publish to this topic, allowing any number of sources of information to be used. There are three main files – one for the Time, a second for the News Feed and a the third for Weather conditions.
Getting the Time:
All our files are available via the Connected Environments githib for THE – https://github.com/ucl-casa-ce/THE
For the time – download timetomqtt.py.
The script gets the current time and converts it to words for display on THE – so, for example, 12.14pm becomes The Time is Fourteen Minutes Past Twelve and so on. In the script you need to edit it to add in your own MQTT details  – we have highlighted the parts to edit in the code.
Copy it across to your Pi in a folder – we use /home/pi/scripts  – this can be down either via the command line or via ftp via Filezilla or similar.
Getting the News:
For the news, download rsstomqtt.py.
The script gets the latest news from Sky and publishes it to MQTT for THE. You can edit the news source as required in the file. This file can also be copied to pull in any RSS feed directly onto your THE. As before, in the script you need to edit it to add in your own MQTT details  – we have highlighted the parts to edit in the code.
Getting the Weather:
For the weather, download darkskytomqtt.py
You need to sign up to use the Darksky API (don’t worry, it’s free and allows up to 1000 calls a day, more than enough to display the latest weather on THE). In our script, simply put in your DarkSky key, which you will receive when you sign up to the API and also your longitude and latitude for the location you want to obtain the data for.
You can find a long and lat via  https://www.latlong.net/
If all this is new then it may sound complicated but with a little trial and error you will be able to edit files, write your own and get the information you want on THE in no time. Any issues just drop is a line via the contact form below..

Step Three – THE 
Once you have the scripts to collect the feeds you needs to install the main script to run THE.
Download THE_pi_what.py
As with the other scripts, edit where indicated and add in your own MQTT details. Once edited, copy it across to your Pi with your other scripts.
Finally you need the font and the background image:
Download hm.ttf (the font)
Download whatbackground.png
These go in a new folder called ‘resources’ inside the scripts folder you crearted on your pi – simply create the new folder and copy the files across.

Step Four – Run the Scripts at Set Times.
The scripts run at set times on the pi via the cron service. To set this up, simply log into your pi via ssh and type

sudo crontab -e

This sets up a new cron process – if asked select option ‘2’ to edit with nano – copy the following into the cron file and save (cntl x).

*/5 * * * * python3 /home/pi/scripts/timetomqtt.py
*/12 * * * * python3 /home/pi/scripts/rsstomqtt.py
*/18 * * * * python3 /home/pi/scripts/darkskytomqtt.py
@reboot sleep 10 && python3 /home/pi/scripts/THE_pi_what.py
*/60 * * * * sudo reboot

 
The scripts run at set times – change them to any time to wish. We reboot the pi every hour to keep things fresh – this is not required and we know it is not the best of practice but we have found it keeps things running for our purposes.

Step Five
Reboot your Pi and sit back and wait  – your feeds will appear according the time intervals you set in your cron scripts.
You can edit the files and add as many sources of information as you like.
Do let us know if you make one, edit any scripts or remix the case.