This script automates the process of logging into the Arbor portal, extracting school messages, and forwarding them to a specified email address.
The messages come as a single run-on line, and there is no subject. Adding paragraph breaks and a subject line greatly improves readability. To enable, specify your OPENAI_API_KEY in the .env file.
- Arbor account
- E-mail account with IMAP access
- (optionally) OpenAI API key
- Ensure Python 3.10 is installed on your machine. Earlier or later versions of Python may or may not work.
- Clone or download this script to your local machine.
- Install the required Python packages by running
pip install -r requirements.txt. - Rename
.env.templateto.envand update it with your Arbor, IMAP, and (optionally) OpenAI credentials, the e-mail the messages will appear to have been sent from, and the forwarding email. - If the Arbor portal is not in the same timezone, set
ARBOR_TIMEZONEin the.envfile (e.g.Europe/London).
Run the script with python arbor_message_forwarder.py from Cron. The script will automatically perform all its tasks in the background, and new messages should automatically appear in your forwarding e-mail inbox.
The messages are automatically labelled with the label Arbor (configurable in the .env file), so you can easily find them in your inbox, or filter/forward them. Alternatively, you can automacially add a prefix to the subjects of the messages.
On the first run, the script will attempt to install a version of the Chromium browser compatible with Pyppeteer (if it is not already installed).
(OS X only) If you want to run from cron periodically (recommended), go to System Settings > Privacy & Security > Full Disk Access, and add /usr/sbin/cron to the list, then either restart the computer, or run the following commands from the terminal:
sudo launchctl stop com.apple.periodic-daily
sudo launchctl start com.apple.periodic-daily