aneisch/informed-delivery-home-assistant repository overview

⁠Informed Delivery Home Assistant

Retrieves USPS mail and package info from informed delivery emails via IMAP. Publishes mail and package count to MQTT and creates scanned mail gif. This container image was created based on content from the top link, check it out for additional Home Assistant sensor integration info. Credit to @skalavala⁠ and arychj⁠ for the code and writeup!

• https://www.awesome-automations.com/blog/usps/⁠
• https://community.home-assistant.io/t/a-working-usps-component-solved-for-now/41012/14⁠

https://hub.docker.com/r/aneisch/informed-delivery-home-assistant⁠

⁠Usage

⁠Example docker-compose:

version: '3.2'
services:
    informed_delivery:
        container_name: informed_delivery
        image: aneisch/informed-delivery-home-assistant
        volumes:
          - '/etc/localtime:/etc/localtime:ro'
          # volume for mails image output
          - '/tmp/:/output/'
        environment:
          - EMAIL_USERNAME=your_email@your_provider.com
          - EMAIL_PASSWORD=your_password
          - MQTT_USPS_MAIL_TOPIC=/sensor/usps/mails
          - MQTT_USPS_PACKAGE_TOPIC=/sensor/usps/packages
          - SLEEP_TIME_IN_SECONDS=600

⁠Example docker run:

docker run -d -v '/tmp/:/output/' -v '/etc/localtime:/etc/localtime:ro' \
--name informed_delivery -e EMAIL_USERNAME=your_email@your_provider.com \
-e EMAIL_PASSWORD=your_password -e SLEEP_TIME_IN_SECONDS=600 \
aneisch/informed-delivery-home-assistant

⁠Environmental Variables

You only need to specify the environmental variables in docker run or your docker-compose file that you want/need to override:

⁠Notes:

• If using Gmail, you will need to allow less secure apps⁠ to login. I suggest making a separate Google account for this. You will also need to enable IMAP from your Gmail inbox.
• If MQTT doesn't require login you can leave MQTT_USERNAME and MQTT_PASSWORD as is.