blueshiftlabs / home-assistant-mail-and-packages Goto Github PK

The Mail and Packages integration creates sensors for supported shippers to show a snapshot of mail and packages that are in transit or delviered that are scheduled to be delivered the current day. It also generates the number of USPS mail pieces and provides a rotating GIF of the USPS provided images of the mail, if available, for the current day.

• Huge contributions from @firstof9 moving the project forward and keeping it active!

From your instance of HASS, the Mail and Packages integration connects to the email account you supply where your shipment notifications are sent. It reviews at the subject lines of the current day's emails from the supported shippers and counts the subject lines that match known language from the supported shippers about their transit status for packages that are scheduled to be delivered the current day. For USPS Informed delivery emails, it also downloads the mail images to combine them into a rotating GIF.

• All procedures are done locally on your machine.
• No external services are used to process your email.
• No data is sent outside of your local instance of Home Assistant

Please note that files stored in the www Home Assistant folder is publicly accessible unless you have taken security measures outside of Home Assistant to secure it. You can place the images in an images directory inside Home Assistants root folder and still send notifications via most notification integrations.

See the WIKI information on how this works.

See the WIKI for configuring the integration.

See the WIKI for account settings needed for certain shippers.

See the WIKI for example automations and templates.